Zeoel Sprint Planner

Zeoel Phase 2: Sprint Planning

Overview

Translate the PROJECT_BRIEF.md into actionable sprints. Gohar (CEO) breaks down the work into bite-sized tasks and assigns each task to the most appropriate Zeoel sub-agent with their skill bindings explicitly listed.

If any are missing, tell the user: "Phase 1 is incomplete. I need to run the brainstorm first." Then invoke zeoel-brainstorm.

References

Read these before planning:

• Sprint plan template: .agents/skills/zeoel/references/sprint-plan-template.md
• Skill mapping: .agents/skills/zeoel/references/skill-mapping-reference.md — maps all 116 skills to agents
• SaaS architect (if SaaS): .agents/skills/zeoel/skills/zeoel-saas-architect/SKILL.md

The Process (Follow in Order)

Step 1: Read PROJECT_BRIEF.md

Understand the scope, architecture, tech stack, and team assignments.

Step 2: Decompose into Sprints

Break the project into 1-5 sprints. Rules:

• Each sprint MUST deliver working, testable software.
• Sprint 0 is MANDATORY for SaaS projects (scaffold, auth, base DB, SEO infrastructure).
• Keep sprints focused: 5-10 tasks max per sprint.

Step 3: Task Breakdown

Within each sprint, define tasks. Rules:

• Tasks MUST be small (15-30 mins of work each).
• No placeholders: Do not write "implement backend". Write "Create UserController.php with store and index methods."
• TDD focus: Sequence tests BEFORE implementation in the task list.
• Clear boundaries: Ensure two agents aren't modifying the same file.
• Required Tests column is MANDATORY: Every code-producing task must specify what tests are expected (e.g., "Component test + accessibility test", "Feature test + auth bypass test"). Design/coordination tasks can use "—".
• Model Tier column is MANDATORY: Gohar MUST assign a complexity tier (🟢 Light / 🟡 Standard / 🔴 Complex) to each task for intelligent model routing. See .agents/skills/zeoel/skills/zeoel-dispatch/SKILL.md Step 3.5 for the tier definitions.

Step 4: Agent Assignment with Skill Bindings

For EVERY task, explicitly assign an agent AND list the skills they will use:

The plan.md MUST include the "Skills to Load" column AND the "Model Tier" column in the task table.

Step 5: Team Consilium (Mandatory)

Before finalizing the plan, run a team consilium where each relevant agent reviews from their perspective:

• Gohar: Timeline realistic? What to cut?
• Karar: Technically feasible? Scope risks?
• Tariq: Security concerns? API design issues?
• Zara: SEO coverage? Missing pages or meta?
• Muhammad: Testable? Edge cases?
• Ali: Deployment feasibility? Infrastructure needs?

Flag issues and revise the plan before presenting to the user.

Step 6: Write Sprint Documents

Create ALL of these files:

docs/sprint-N/plan.md — Using the template from references/sprint-plan-template.md:

• Sprint goal and branch name
• Prioritized task list with Agent + Skills + Required Tests + Model Tier columns
• Work schedule with phases
• Success criteria (testable checkboxes)
• What's NOT in this sprint
• Execution dispatch instructions

docs/sprint-N/progress.md — Using the template from references/sprint-plan-template.md (Progress Tracker section):

• Task status table (all tasks start as ⬜ Not started)
• Audit Checkpoints section (empty, filled during Phase 3)
• Bugs Found section (empty)
• Notes section (empty)

docs/sprint-N/deferred.md — Using the template from references/sprint-plan-template.md (Deferred Items Tracker section):

• Deferred Items table (empty or pre-populated from plan's "What's NOT in This Sprint")
• Simplifications Made table (empty)

docs/deferred/backlog.md — Using the template from references/sprint-plan-template.md (Cumulative Deferred Backlog section):

• Create once (first sprint), then update for subsequent sprints
• Review any pending items from previous sprints

Pre-create audit doc stubs (empty, to be filled during Phase 3 incremental audits):

• docs/qa/sprint-N-signoff.md — empty with header
• docs/security/sprint-N-audit.md — empty with header
• docs/seo/sprint-N-audit.md — empty with header (if sprint has public pages)

Step 6.5: Verify ALL Mandatory Documents Were Created (BLOCKING)

Print this verification:

═══════════════════════════════════════════
  SPRINT N PLANNING — DOCUMENT VERIFICATION
═══════════════════════════════════════════
  [ ] docs/sprint-N/plan.md          — Created
  [ ] docs/sprint-N/progress.md      — Created (empty template)
  [ ] docs/sprint-N/deferred.md      — Created (empty template)
  [ ] docs/deferred/backlog.md       — Created or Updated
  [ ] docs/qa/sprint-N-signoff.md    — Created (empty stub)
  [ ] docs/security/sprint-N-audit.md — Created (empty stub)
  [ ] docs/seo/sprint-N-audit.md     — Created (empty stub, if public pages)
═══════════════════════════════════════════

If ANY item is ❌, go back and create it NOW. Do NOT present the plan to the user until ALL items are ✅.

Step 7: User Review

Present the sprint plan to the user. They MUST approve before execution begins.

Step 8: Transition to Phase 3

Once approved, invoke zeoel-dispatch for Phase 3 (Execution).

• Read .agents/skills/zeoel/skills/zeoel-dispatch/SKILL.md.

Mandatory Outputs

At the end of Phase 2, these files MUST exist FOR EACH planned sprint:

If any file is missing, Phase 2 is NOT complete. Do NOT proceed to Phase 3.

Critical Rules for Plans

• No placeholders: Do not write "implement backend". Write "Create UserController.php with store and index methods."
• TDD focus: Always sequence tests before implementation in the task list.
• Clear boundaries: Ensure Karar and Tariq aren't trying to modify the same file in parallel.
• Skills column is mandatory: Every task MUST list which skills the assigned agent will use.
• Required Tests column is mandatory: Every code-producing task MUST specify what tests are expected.
• Model Tier column is mandatory: Every task MUST have a complexity tier for intelligent model routing.
• Sprint 0 for SaaS: Always start with a foundation sprint for SaaS projects.
• Deferred.md is mandatory: Even if nothing is deferred, create the file with "No items deferred."
• Audit doc stubs are mandatory: Pre-create empty audit docs so incremental audits can append to them during Phase 3.