ilandahan/AID / skills/aid-impl-plan
aid-impl-plan
VerifiedAID Phase 3 - Implementation Planning with consolidation-first approach. Resolves contradictions between PRD and Tech Spec, creates consolidated master document, then breaks down into actionable tasks and populates Jira. Includes sprint planning and risk assessment.
AID Implementation Plan Skill (Phase 3)
Applies to AID Phase 3 only. Run sub-phases in order: 3a Consolidation → 3b Breakdown → 3c Criteria Gen → 3d Jira Population.
Templates & References
Templates:
references/templates/epic-template.mdreferences/templates/story-template.mdreferences/templates/task-template.mdreferences/templates/contradiction-log-template.md
Methodology:
references/phase3-methodology.mdreferences/content-mapping.mdreferences/criteria-generator.mdreferences/iron-rules.md
Key Principle: PRD Content → Epics & Stories (WHY/WHAT), Tech Spec Content → Tasks (HOW)
Golden Rules of Phase 3
Rule #1: NO WORD LEFT BEHIND
Every word from source documents MUST appear in Jira:
- PRD content → Epics/Stories
- Tech Spec content → Tasks
- OpenAPI endpoints → Implementation Tasks
Verification: Create traceability matrices. 100% coverage required before Phase 4.
Rule #2: SMALL TASKS, BIG DOCUMENTS
| Source Size | Task Size |
|---|---|
| < 20 pages | M (4-8 hours) |
| 20-50 pages | S (2-4 hours) |
| 50-100 pages | XS-S (1-4 hours) |
| > 100 pages | XS (1-2 hours) |
Rule #3: PROCESS IN CHUNKS, WRITE IMMEDIATELY
Wrong: Read all → Think → Write at end (loses info) Right: Read section → Write to enriched file → Next section (progressive capture)
Rule #4: VERIFY BEFORE PROCEEDING
Before Phase 4:
- Every PRD user story → Story in Jira
- Every Tech Spec component → Tasks
- Every Task has all required fields
- Coverage < 100%? Find gaps → Add items → Re-verify
Phase 3a: Contradiction Resolution & Consolidation
Purpose: Find and resolve ALL contradictions between PRD, Tech Spec, and Research BEFORE consolidating.
Process:
- Document Discovery & Section Mapping
- Create Processing Order (dependency order)
- Section-by-Section Consolidation
- Contradiction Analysis (per section)
- Resolution Hierarchy: Research > PRD > Tech Spec
- Progressive Document Building
Contradiction Types:
| Type | Priority |
|---|---|
| Scope conflicts | 1 (Critical) |
| Technical conflicts | 1 (Critical) |
| Requirement gaps | 2 (High) |
| Implementation conflicts | 2 (High) |
| Minor inconsistencies | 3 (Low) |
Resolution Template:
## Contradiction #[N]
**Found In:** [PRD section] vs [Tech Spec section]
**Description:** [What conflicts]
**Resolution:** [How resolved]
**Authority Used:** [Research/PRD/Tech Spec]
**Rationale:** [Why]
Phase 3a Checkpoint: User approval required before proceeding to 3b.
Phase 3b: Task Breakdown
Purpose: Transform consolidated spec into actionable development tasks.
Component Categories:
- Backend: API, Database, Business Logic, Integrations
- Frontend: Pages, Components, State, API Integration
- Infrastructure: Database Setup, Config, CI/CD
- Cross-Cutting: Auth, Logging, Error Handling
Task Decomposition Rules:
| Rule | Requirement |
|---|---|
| Size | < 4 hours (prefer 1-2) |
| Independence | Completable alone (unless dependency) |
| Testability | Clear acceptance criteria |
| Traceability | Links to spec section |
Estimation:
| Type | Unit | Range |
|---|---|---|
| Epic | Sprints | 1-3 |
| Story | Story Points | 1,2,3,5,8,13 |
| Task | Hours | 1-8 |
| Subtask | Minutes/Hours | 15min-4hr |
Risk Template:
### Risk: [Name]
- **Category:** [Technical/Dependency/Resource/Timeline/Scope]
- **Probability:** [High/Medium/Low]
- **Impact:** [High/Medium/Low]
- **Mitigation:** [Strategy]
- **Contingency:** [Backup plan]
Phase 3c: Success Criteria Generation (QA Gate Setup)
Purpose: Generate testable acceptance criteria for QA sub-agent validation.
Information Boundaries:
| Level | Contains | Source | Forbidden |
|---|---|---|---|
| Epic | Business Logic (WHY) | Research+PRD | Tech HOW |
| Story | Product Logic (WHAT) | PRD | Tech HOW |
| Task | Technical Approach (HOW) | Tech Spec | Business WHY |
| Sub-task (QA) | Acceptance Criteria (VERIFY) | Story AC | Tech HOW |
Output: .aid/qa/{task-id}.yaml
schema_version: "1.0"
task_id: "{TASK-ID}"
business_context:
epic_goal: "{sanitized}"
user_value: "{sanitized}"
acceptance_criteria: []
criteria:
must_achieve: []
must_not: []
not_included: []
best_practices: []
files_to_review: []
review_history: []
Phase 3c Checkpoint: Human approval required before Jira population.
Phase 3d: Jira Population
Step 1: Create Structure
- Create all Epics (summary, priority, labels)
- Create all Stories under Epics
- Create all Tasks under Stories
- Create all Subtasks under Tasks
- Link all dependencies
Step 2: Enhance with Full Details — for each issue, add:
- Full business context (PRD)
- Technical implementation (Tech Spec)
- Acceptance criteria
- Technical notes
- Test strategy
- Reference to consolidated spec
Enhancement Template:
## Summary
[What this accomplishes]
## Business Context
[From PRD]
## Technical Implementation
[From Tech Spec]
## Acceptance Criteria
- [ ] [Criterion 1]
- [ ] [Criterion 2]
## Dependencies
- Blocks: [keys]
- Blocked By: [keys]
## Reference
📄 Consolidated Spec: [path]
📑 Section: [name]
Alternative Export: CSV/JSON for non-Jira users.
Lessons Learned
- Stage enriched content in
docs/implementation-plan/enriched-jiras/before pushing to Jira - Never skip Story layer - Epic → Story → Task (not Epic → Task)
- Spec fixes are NOT developer work - fix source documents directly
- Content mapping is mandatory - PRD → Epic/Story, Tech Spec → Task
- Verification is mandatory - run coverage agents before Phase 4
- Use ADF for Jira - Atlassian Document Format for rich descriptions
- Task naming: E{Epic#}-T{Sequential##}: {Verb} {Component}
- Every task needs: Description, Files, Code pattern, API contract, Error handling, AC, Estimate, Spec reference
Output Artifacts
| Artifact | Location |
|---|---|
| Consolidated Spec | docs/implementation-plan/consolidated-spec-YYYY-MM-DD-[feature].md |
| Contradiction Log | docs/implementation-plan/contradiction-log-YYYY-MM-DD.md |
| Task Breakdown | docs/implementation-plan/task-breakdown-YYYY-MM-DD-[feature].md |
| Jira Export | docs/implementation-plan/jira-export-YYYY-MM-DD.json |
| Risk Assessment | docs/implementation-plan/risks-YYYY-MM-DD.md |
| Sprint Plan | docs/implementation-plan/sprint-plan-YYYY-MM-DD.yaml |
Exit Criteria (Phase 3 → Phase 4)
- Phase 3a: Consolidated doc created, user approved
- Phase 3b: Tasks < 4hr, acceptance criteria, dependencies mapped
- Phase 3c: QA criteria files generated, human approved
- Phase 3d: Jira populated, all issues have full descriptions
- Quality Gates: Sub-agent review PASSED
Commands
| Command | Purpose |
|---|---|
| /impl-plan | Start Phase 3 |
| /consolidate | Run Phase 3a |
| /breakdown | Run Phase 3b |
| /populate-jira | Run Phase 3d |
State Tracking
.aid/state.json:
{
"current_phase": 3,
"sub_phase": "3b",
"phase_3_state": {
"3a": {"status": "complete", "user_approved": true},
"3b": {"status": "in_progress"},
"3c": {"status": "locked"},
"3d": {"status": "locked"}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |