git-learn/openspec/archive/2026-05-21-sm-flow-v3-1-upgrade/tasks.md

1. OpenSpec Commit Gate

• 1.1 Update .agents/skills/sm-flow/SKILL.md to describe Draft OpenSpec, Committed OpenSpec, Phase 2.9, and the Phase 3 executable gate.
• 1.2 Update .agents/skills/sm-flow/references/phase-contracts.md with Phase 2.9 entry/action/output/exit criteria.
• 1.3 Add Phase 3 preflight checks for unresolved user-interview questions, interface impact, devflow conflicts, and executable task/spec quality.
• 1.4 Require Phase 2 grill user-interview questions to wait for explicit user confirmation before they can be marked resolved.
• 1.5 Require explicit Phase 3 apply authorization after Phase 2.9; individual grill confirmations must not authorize execution target file changes.

2. Interface Impact Rules

• 2.1 Add interface impact level definitions and inline-vs-standalone documentation rules to the sm-flow protocol.
• 2.2 Add an interface impact template to .agents/skills/sm-flow/references/templates.md.
• 2.3 Update Phase 1.5 / Phase 2 checks so interface changes are identified before Phase 3.

3. Devflow Context Indexing

• 3.1 Add devflow index lookup order to Phase 0.5.
• 3.2 Create or update devflow/index.md with existing project entries.
• 3.3 Update Phase 4 rules so future project backfills maintain the index.

4. Apply Conflict Handling

• 4.1 Add Phase 3 implementation-time conflict classification rules.
• 4.2 Update .agents/skills/sm-flow/references/fallbacks.md so execution fallback pauses and repairs OpenSpec for spec-affecting conflicts.
• 4.3 Ensure conflict classifications are recorded in devflow decisions or acceptance notes.

5. Compatibility and Documentation

• 5.1 Reword sub-skill compatibility rules to bind to capability contracts first and implementation paths second.
• 5.2 Update skill-workbench/docs/sm-flow/workflow.md with the final v3.1 design.
• 5.3 Run OpenSpec status checks and text searches to verify the new terms are consistently documented.