artifact-templates

name	artifact-templates
description	Agent-only reference providing canonical output templates for all rp1 artifacts (requirements, design, tasks, reports, KB docs). Load when producing any structured markdown artifact to ensure format consistency and correct routing metadata. Not user-invocable -- agents read the index to find the right template, then read the template file via the Read tool.
metadata	{"category":"knowledge","is_workflow":false,"user_invocable":false}

Artifact Templates

Centralized output templates for all rp1 artifact types. Agents read templates to produce correctly formatted, correctly routed artifacts.

Usage

1. Read this SKILL.md to find the template for your artifact type in the index below.
2. Read the template file at the listed path (relative to this skill directory).
3. Fill placeholders ({FEATURE_ID}, {Date}, [bracketed text]) with actual values.
4. Write the artifact to the location specified by scope + path_pattern.
5. If the template includes emit_hint, the producer MUST register the artifact after writing it.

Templates contain YAML frontmatter with routing metadata and a markdown body with the artifact format. Section-level templates (type: section) are appended to existing files, not written as standalone documents.

Active /build artifacts are producer-owned: the agent that writes the artifact registers that exact path with explicit storageRoot. Do not recover active build artifacts by directory scan. Do not generate or register legacy tracker.md or milestone-*.md artifacts for new work.

Template Index

Producer	Artifact	Type	Scope	Path Pattern	Template Path
feature-requirement-gatherer	requirements.md	document	workRoot	features/{FEATURE_ID}/requirements.md	templates/feature-requirement-gatherer/requirements.md
feature-architect	design.md	document	workRoot	features/{FEATURE_ID}/design.md	templates/feature-architect/design.md
feature-architect	design-decisions.md	document	workRoot	features/{FEATURE_ID}/design-decisions.md	templates/feature-architect/design-decisions.md
feature-tasker	tasks.md	document	workRoot	features/{FEATURE_ID}/tasks.md	templates/feature-tasker/tasks.md
feature-tasker	tasks.json	data	workRoot	features/{FEATURE_ID}/tasks.json	templates/feature-tasker/tasks.json
feature-verifier	verification-report.md	document	workRoot	features/{FEATURE_ID}/feature_verification_{N}.md	templates/feature-verifier/verification-report.md
build-verify-aggregator	build-readiness.md	document	workRoot	features/{FEATURE_ID}/build-readiness.md	templates/build-verify-aggregator/build-readiness.md
feature-editor	edit-marker	section	workRoot	features/{FEATURE_ID}/requirements.md (append)	templates/_sections/edit-marker.md
hypothesis-tester	hypothesis-document.md	document	workRoot	features/{FEATURE_ID}/hypotheses.md	templates/hypothesis-tester/hypothesis-document.md
research-reporter	research-report.md	document	workRoot	research/{YYYY-MM-DD}-{TOPIC_SLUG}.md	templates/research-reporter/research-report.md
project-documenter	birds-eye-view.md	document	workRoot	birds-eye/{YYYY-MM-DD}-{PROJECT_SLUG}.md	templates/project-documenter/birds-eye-view.md
security-validator	security-report.md	document	workRoot	security/{REPORT_ID}/report.md	templates/security-validator/security-report.md
pr-review-reporter	pr-review-report.md	document	workRoot	pr-reviews/{REVIEW_ID}-review-{NNN}.md	templates/pr-review-reporter/pr-review-report.md
pr-walkthrough-reporter	pr-walkthrough.md	document	workRoot	pr-walkthroughs/{REVIEW_ID}-walkthrough-{NNN}.md	templates/pr-walkthrough-reporter/pr-walkthrough.md
pr-feedback-collector	pr-feedback-tasks.md	document	workRoot	pr-reviews/{IDENTIFIER}-feedback-{NNN}.md	templates/pr-feedback-collector/pr-feedback-tasks.md
code-auditor	audit-report.md	document	workRoot	audits/{SCOPE}/report.md	templates/code-auditor/audit-report.md
bug-investigator	investigation-report.md	document	workRoot	investigations/{BUG_ID}/report.md	templates/bug-investigator/investigation-report.md
build-fast-planner	quick-build.md	document	workRoot	quick-builds/{ID}/quick-build.md	templates/build-fast-planner/quick-build.md
socratic-duel	managed-debate-region	section	absolute	{TARGET_PATH} (managed region)	templates/socratic-duel/managed-debate-region.md
socratic-duel	debate-artifact.md	document	workRoot	debates/{YYYY-MM-DD}-{TOPIC_SLUG}{UNIQUE_SUFFIX}.md	templates/socratic-duel/debate-artifact.md
phase-planner	phase-plan.md	document	workRoot	{PHASE_PLAN_DIR}/{PHASE_PLAN_FILENAME}	templates/phase-planner/phase-plan.md
blueprint-wizard	prd.md	document	workRoot	prds/{PRD_NAME}.md	templates/blueprint-wizard/prd.md
blueprint-auditor	prd-audit-results.md	document	workRoot	prds/{PRD_NAME}-audit.md	templates/blueprint-auditor/prd-audit-results.md
prd-archiver	closure-summary.md	document	workRoot	archives/prds/{PRD_NAME}/closure-summary.md	templates/prd-archiver/closure-summary.md
charter-interviewer	charter.md	document	kbRoot	charter.md	templates/charter-interviewer/charter.md
speedrun	session-log.md	document	workRoot	speedrun/{SESSION_ID}/log.md	templates/speedrun/session-log.md
task-builder	implementation-summary	section	workRoot	features/{FEATURE_ID}/tasks.md (append)	templates/_sections/implementation-summary.md
task-reviewer	verification	section	workRoot	features/{FEATURE_ID}/tasks.md (append)	templates/_sections/verification.md
knowledge-base	index.md	document	kbRoot	index.md	templates/knowledge-base/single-project/index.md
knowledge-base	concept_map.md	document	kbRoot	concept_map.md	templates/knowledge-base/single-project/concept_map.md
knowledge-base	architecture.md	document	kbRoot	architecture.md	templates/knowledge-base/single-project/architecture.md
knowledge-base	interaction-model.md	document	kbRoot	interaction-model.md	templates/knowledge-base/single-project/interaction-model.md
knowledge-base	modules.md	document	kbRoot	modules.md	templates/knowledge-base/single-project/modules.md
knowledge-base	patterns.md	document	kbRoot	patterns.md	templates/knowledge-base/single-project/patterns.md
knowledge-base	index.md (monorepo)	document	kbRoot	index.md	templates/knowledge-base/monorepo/index.md
knowledge-base	concept_map.md (monorepo)	document	kbRoot	concept_map.md	templates/knowledge-base/monorepo/concept_map.md
knowledge-base	architecture.md (monorepo)	document	kbRoot	architecture.md	templates/knowledge-base/monorepo/architecture.md
knowledge-base	interaction-model.md (monorepo)	document	kbRoot	interaction-model.md	templates/knowledge-base/monorepo/interaction-model.md
knowledge-base	modules.md (monorepo)	document	kbRoot	modules.md	templates/knowledge-base/monorepo/modules.md
knowledge-base	patterns.md (monorepo)	document	kbRoot	patterns.md	templates/knowledge-base/monorepo/patterns.md
knowledge-base	dependencies.md (monorepo)	document	kbRoot	dependencies.md	templates/knowledge-base/monorepo/dependencies.md
knowledge-base	technology-matrix.md (monorepo)	document	kbRoot	technology-matrix.md	templates/knowledge-base/monorepo/technology-matrix.md
knowledge-base	state.json	data	kbRoot	state.json	templates/knowledge-base/state.json
knowledge-base	meta.json	data	kbRoot	meta.json	templates/knowledge-base/meta.json
prompt-eval-builder	promptfoo-config	document	-	(agent-determined)	templates/prompt-eval-builder/promptfoo-config.yaml

For Socratic Duel, managed-debate-region is retained for legacy in-progress duels. New artifact-backed runs use debate-artifact.md under workRoot.

Template Frontmatter Schema

Each template file contains YAML frontmatter with these fields:

Field	Type	Required	Description
scope	enum	Yes	workRoot, kbRoot, or absolute -- base directory for the artifact; absolute uses path_pattern as a caller-resolved path
path_pattern	string	Yes	Relative path from scope root with {PLACEHOLDER} variables
producer	string	Yes	Canonical name of the agent or skill that produces this artifact
type	enum	Yes	document (standalone file), section (appended to existing), or data (JSON/YAML)
description	string	Yes	When to use this template; one sentence
strictness	enum	No	strict (exact structure required) or flexible (guidance, agents may adapt). Default: strict
emit_hint	string	No	Suggested rp1 agent-tools emit command for artifact registration
conditions	list	No	Conditions under which sections are included/excluded

KB Templates

Templates under templates/knowledge-base/ are organized by project type:

• single-project/: Standard single-project KB documentation (index, concept_map, architecture, interaction-model, modules, patterns)
• monorepo/: Multi-project KB documentation (adds dependencies, technology-matrix)
• state.json: KB metadata tracking template
• meta.json: Local-only values template (not committed)

See references/REFERENCE.md for detailed KB template customization guide and references/EXAMPLES.md for filled-in examples.

Directory Layout

templates/
+-- _sections/                        # Section-level templates (type: section)
|   +-- edit-marker.md
|   +-- implementation-summary.md
|   +-- verification.md
+-- blueprint-auditor/
+-- blueprint-wizard/
+-- bug-investigator/
+-- build-verify-aggregator/
+   +-- build-readiness.md
+-- build-fast-planner/
+-- charter-interviewer/
+-- code-auditor/
+-- feature-architect/
|   +-- design.md
|   +-- design-decisions.md
+-- feature-requirement-gatherer/
+-- feature-tasker/
|   +-- tasks.md
|   +-- tasks.json
+-- feature-verifier/
+-- hypothesis-tester/
+-- knowledge-base/
|   +-- meta.json
|   +-- state.json
|   +-- monorepo/
|   +-- single-project/
+-- phase-planner/
+-- pr-feedback-collector/
+-- pr-review-reporter/
+-- pr-walkthrough-reporter/
+-- prd-archiver/
+-- project-documenter/
|   +-- birds-eye-view.md
+-- prompt-eval-builder/
+-- research-reporter/
+-- security-validator/
+-- socratic-duel/
|   +-- debate-artifact.md
|   +-- managed-debate-region.md
+-- speedrun/