Skip to content

Consolidate agent shutdown SSOT into CLAUDE.md lifecycle table #169

@michael-wojcik

Description

@michael-wojcik

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions