Skip to content

feat: add plan-aware Phase 1 workflow#15

Merged
ducdmdev merged 16 commits intomainfrom
feat/plan-aware-phase1
Mar 17, 2026
Merged

feat: add plan-aware Phase 1 workflow#15
ducdmdev merged 16 commits intomainfrom
feat/plan-aware-phase1

Conversation

@ducdmdev
Copy link
Owner

@ducdmdev ducdmdev commented Mar 17, 2026

Summary

  • Phase 1 now detects existing plan files, creates plans via writing-plans skill when none exist, audits all plans through a 7-check gate, and derives team decomposition from the approved plan
  • Adds Early Exit for trivial tasks and Budget Constraints to keep Phase 1a lightweight
  • Adds Plan Status Update step in Phase 5 to mark plans as COMPLETED/PARTIAL/ABANDONED after team finishes
  • All 5 archetype skills updated with Phase 1a/1b references and Phase 5 Plan Status Update

Design

  • Spec: docs/specs/2026-03-17-plan-aware-phase1-design.md
  • Plan: docs/plans/2026-03-17-plan-aware-phase1.md
  • 5-phase contract preserved — Phase 1 expands into 1a (plan detection) + 1b (decomposition)
  • Plan-awareness logic lives in shared-phases.md, inherited by all archetypes

Files changed (10)

  • docs/shared-phases.md — Core Phase 1a, 1b, Phase 2 template, Phase 5 plan status
  • docs/workspace-templates.md — Plan File Conventions, updated Phase Checklist
  • docs/team-archetypes.md — Plan-aware detection note
  • skills/agent-{team,implement,research,audit,plan}/SKILL.md — Phase 1 + Phase 5 overrides
  • README.md — Updated How It Works

Test plan

  • Full test suite: 97/98 pass (1 pre-existing claude plugin validate CLI issue)
  • Doc reference tests: all cross-references resolve (0 missing)
  • Structural audit: 15/15 checks pass (cross-refs, step numbering, content consistency)
  • Dry-run: plan scan with existing plans — correctly finds matching plan, filters COMPLETED plans, all 7 audit checks pass, User Decision Gate presents clean result
  • Dry-run: no plan found path — correctly falls through to plan creation, context gathering works, writing-plans invocation unambiguous, fallback path traced
  • Dry-run: Phase 5 status update — correctly follows archetype → shared reference chain, produces correct status string COMPLETED — Implemented via team {name} (YYYY-MM-DD)
  • 5 issues found during dry-run testing — all fixed (fallback log timing, add-or-update wording, IN PROGRESS at Phase 3, root glob scope, date format)

ducdmdev added 16 commits March 12, 2026 09:55
- Remove package.json (not an npm package, version sync now only plugin.json + marketplace.json)
- Remove LICENSE file and references from README and marketplace.json
- Update CI and release workflows to drop package.json version checks
- Update test-plugin-validation.sh to check 2 files instead of 3
- Move *-design.md files from docs/plans/ to docs/specs/
Introduces plan detection, creation (via writing-plans skill), audit gate,
and plan-driven decomposition into the Agent Team Phase 1 workflow.
Includes Phase 5 plan status update on completion.
- Add fallback for missing writing-plans skill (inline plan creation)
- Clarify archetype detection timing (Step 0: dedicated vs hybrid)
- Reframe Phase 5 plan status as completion step, not gate check
- Add early exit for trivial tasks
- Add budget constraints for Phase 1a scanning
- Fix plan retention logic for "Create new" option
- Add monorepo scan scoping and minimum plan structure requirements
- Remove redundant Phase 1b Step 5 (file ownership), merge into Step 2
- Change Phase 5 plan status from renumbered step to unnumbered shared section
- Add Phase 5 Override updates to all 5 archetype tasks (Tasks 8-12)
- Fix fallback log instruction (workspace doesn't exist in Phase 1a)
- Change "update" to "add or update" for plan Status field
- Add IN PROGRESS instruction to Phase 3 workspace init
- Clarify Priority 7 scan as non-recursive with deduplication
- Specify YYYY-MM-DD date format in status strings
@ducdmdev ducdmdev merged commit 8147b5c into main Mar 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant