Feature Specification: Participant Roles

[markhazleton]

Summary

• Document the participant roles feature and complete the lifecycle spec status.
• Define prompt, agent, skill, participant, and role vocabulary while keeping agent reserved for AI runtime/client integrations.
• Add optional advisory participants metadata examples to stock lifecycle templates without changing command, prompt, script, or customization precedence.
• Add contract tests for participant vocabulary, optional metadata behavior, and template/frontmatter preservation.

Changes

• Branch diff: 22 files changed, 1576 insertions(+), 1 deletion(-).
• Includes participant-role spec artifacts, lifecycle/constitution/README documentation updates, template metadata examples, and tests/test_participant_metadata_contract.py.

Task Completion

• 30/30 tasks complete.
• Checklist requirements.md: 20/20 complete, status pass.

Quality Gates

• analyze: pass - prior wording inconsistencies were repaired; artifacts are aligned for implementation.
• critic: pass - critic findings were resolved with explicit metadata and strengthened implementation test tasks.
• checklist: pass - no unresolved findings.

Gate Acknowledgements

• checklist: No unresolved findings.
• analyze: Findings I1 and I2 resolved in .documentation/specs/001-participant-roles/gates/analyze.md.
• critic: Findings critic-001, critic-002, and critic-003 resolved by explicit spec metadata and strengthened implementation test tasks.

Validation

• npx markdownlint-cli2 "README.md" ".documentation/**/*.md" "templates/**/*.md"
• .\.venv\Scripts\python -m pytest -q tests/test_participant_metadata_contract.py
• .\.venv\Scripts\python -m pytest -q
• git diff --check

Spec Reference

• .documentation/specs/001-participant-roles/spec.md