Package the reusable prompt collection under prompts/
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s

HF-WP-0005. The prompts used to drive work across HelixForge repositories
existed only as text pasted between sessions. They are now Canned Prompt Format
v0.2 packages with declared inputs, parameters and output contracts.

Seven packages: repo-orient (merging "what is this repo about" with "what
should we do now" as a `depth` parameter), repo-register, repo-advance,
commit-sync, scope-audit, gap-workplan, session-close.

"Go on implement, please" is deliberately not packaged. It is conversational
continuation with no contract to declare, and packaging it would produce an
artifact whose only content is the word "continue".

Every one of these prompts assumed the operator's setup — the State Hub is a
read model, workplans originate as files and are never registered by hand, a
session closes with a progress event. That assumption is what made them
personal rather than reusable. helix/custodian-conventions states those rules
once as a fragment composed by every package, so they are versioned,
improvable in one place, and present for an agent that has never seen this
fleet.

helix/commit-sync-routine exists for a narrower reason. repo-advance first
composed the whole commit-sync package, which itself composes the conventions,
so the rendered prompt carried the conventions block twice — CPF inclusion does
not deduplicate, and a diamond dependency renders shared content once per path.
Factoring the routine out removes the diamond and is a better factoring
regardless. Recorded upstream as canned-prompts CANP-WP-0004-T03.

helix/session-close composes practice/pqrst-estimate, so the canonical PQRST
block is embedded verbatim. hall-of-helix CLOSING.md says the canonical prompt
still governs when you have no pqrst-practice checkout, without saying how it
reaches you; this is how. evals/pqrst-embedded.yaml fails if the canonical text
stops being embedded verbatim, rather than letting the package quietly become a
paraphrase.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bjefh8NUiEiahN4JLwoSKM

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 388925@bnt-lap001
Assistant-Session: 3507023f-e0fd-4a1e-9d90-a0d4217d1502
This commit is contained in:
tegwick 2026-09-06 17:15:13 +02:00
parent 79e9cd9022
commit 883409665f
22 changed files with 967 additions and 0 deletions

View file

@ -0,0 +1,7 @@
{{ conventions }}
## Task
Review the local changes in this repository, commit what is ready, and sync.
{{ routine }}

View file

@ -0,0 +1,42 @@
format: canned-prompt/v0.2
id: helix/commit-sync
name: Review, Commit and Sync
version: 0.1.0
summary: >
Review the working tree, commit what is ready in coherent commits, and run
the repo's sync so the hub reflects the files.
type: template
template: prompt.md
dependencies:
prompts:
- id: helix/custodian-conventions
version: ">= 0.1.0"
requirement: required
- id: helix/commit-sync-routine
version: ">= 0.1.0"
requirement: required
inputs:
- name: conventions
type: content
required: false
default:
include: helix/custodian-conventions
- name: routine
type: content
required: false
default:
include: helix/commit-sync-routine
output:
format: markdown
description: >
A summary of what was committed, what was deliberately left uncommitted,
and the sync result including any remaining warnings.
license: MIT
tags: [git, sync, hygiene, custodian]
provenance:
author: Bernd Worsch
source: personal prompt collection, contributed 2026-09-06