Context
PR #168 added agent shutdown lifecycle boundaries across 4 files: CLAUDE.md (lifecycle table), orchestrate.md (callout + qualified phase lines), comPACT.md (path-specific callout), and peer-review.md (shutdown timing table).
The per-workflow callouts provide good discoverability (the rule appears at the decision point), but they partially duplicate the CLAUDE.md lifecycle table. As the guidance evolves, maintaining consistency across 4 files creates a maintenance surface.
Proposal
Make CLAUDE.md's lifecycle boundaries table the sole SSOT. Replace per-workflow callouts with references: "> See Agent Shutdown Guidance in CLAUDE.md for lifecycle boundaries."
Trade-offs
- Pro: Single place to update shutdown rules; no risk of drift between files
- Con: Less discoverable — orchestrator must navigate to CLAUDE.md during workflow execution rather than seeing the rule in-context
- Mitigation: Keep brief contextual hints (1-line references) in workflow files pointing to CLAUDE.md
Affected files
pact-plugin/CLAUDE.md (would become comprehensive SSOT)
pact-plugin/commands/orchestrate.md (3 qualified lines + 1 callout → references)
pact-plugin/commands/comPACT.md (1 callout → reference)
pact-plugin/commands/peer-review.md (1 section → reference)
Source
Identified during PR #168 review by backend-coder reviewer.
Context
PR #168 added agent shutdown lifecycle boundaries across 4 files: CLAUDE.md (lifecycle table), orchestrate.md (callout + qualified phase lines), comPACT.md (path-specific callout), and peer-review.md (shutdown timing table).
The per-workflow callouts provide good discoverability (the rule appears at the decision point), but they partially duplicate the CLAUDE.md lifecycle table. As the guidance evolves, maintaining consistency across 4 files creates a maintenance surface.
Proposal
Make CLAUDE.md's lifecycle boundaries table the sole SSOT. Replace per-workflow callouts with references: "> See Agent Shutdown Guidance in CLAUDE.md for lifecycle boundaries."
Trade-offs
Affected files
pact-plugin/CLAUDE.md(would become comprehensive SSOT)pact-plugin/commands/orchestrate.md(3 qualified lines + 1 callout → references)pact-plugin/commands/comPACT.md(1 callout → reference)pact-plugin/commands/peer-review.md(1 section → reference)Source
Identified during PR #168 review by backend-coder reviewer.