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.
| File | Kind | Size |
|---|---|---|
| SKILL.extended.md | markdown | 6.6 KB |
| SKILL.md | skill md | 7.2 KB |
| references/content-mapping.md | markdown | 12.7 KB |
| references/criteria-generator.md | markdown | 7.2 KB |
| references/iron-rules.md | markdown | 19.9 KB |
| references/phase3-methodology.md | markdown | 25.6 KB |
| references/section-mapping-guide.md | markdown | 7.1 KB |
| references/templates/contradiction-log-template.md | markdown | 4.8 KB |
| references/templates/epic-template.md | markdown | 3.6 KB |
| references/templates/story-template.md | markdown | 5.3 KB |
| references/templates/subtask-template.md | markdown | 3.9 KB |
| references/templates/task-template.md | markdown | 6.4 KB |
| templates/consolidated-spec-template.md | markdown | 8.5 KB |
| templates/task-breakdown-template.md | markdown | 5.1 KB |
references/templates/epic-template.md
View on GitHub# Epic Template
## Jira Epic Structure
```
EPIC-{N}: {Domain Name}
├── Story {N}.1: {Capability Group}
│ ├── Task: {Specific Implementation}
│ ├── Task: {Specific Implementation}
│ └── Task: {Specific Implementation}
├── Story {N}.2: {Capability Group}
│ ├── Task: ...
│ └── Task: ...
└── Story {N}.3: {Capability Group}
└── Task: ...
```
---
## Epic Description Template
### Title Format
```
EPIC-{N}: {Domain Name} ({Primary Technology})
```
**Examples:**
- EPIC-1: Infrastructure & DevOps (GCP)
- EPIC-2: Authentication Service (Cloud Functions)
- EPIC-8: Frontend Application (Next.js)
---
### Description Format (Jira-Ready)
```markdown
## Summary
{2-3 sentences describing what this epic delivers and its scope}
## Business Value
{Why this epic matters to users/stakeholders/investors. Connect to PRD goals.}
## User Impact
{Which user personas benefit and how. Reference PRD user stories.}
## Dependencies
- **Blocked by**: {List prerequisite epics that must complete first}
- **Blocks**: {List dependent epics that cannot start until this completes}
- **Parallel with**: {Epics that can run concurrently}
## Success Criteria
{Measurable outcomes from PRD, written as checkboxes}
- [ ] {Outcome 1 - specific, testable}
- [ ] {Outcome 2 - specific, testable}
- [ ] {Outcome 3 - specific, testable}
## Technical Context
{Key architectural decisions from Tech Spec}
- **Primary Technology**: {Framework/service}
- **Database**: {Tables/schemas involved}
- **APIs**: {Endpoints this epic implements}
- **Security**: {Auth/encryption requirements}
## PRD References
- User Stories: {US-XX, US-YY, US-ZZ}
- Requirements Section: {Section number in PRD}
## Tech Spec References
- Architecture Section: {Section number}
- API Contract: {OpenAPI paths}
- Data Model: {Prisma models}
## Estimated Duration
{X-Y days} ({Z story points total})
## Stories in this Epic
{Auto-populated or manually listed}
1. Story {N}.1: {Name}
2. Story {N}.2: {Name}
3. Story {N}.3: {Name}
```
---
## Content Mapping Rules
### What Goes in Epic (FROM PRD)
| PRD Section | Epic Field |
|-------------|------------|
| Product Goals | Business Value |
| User Personas | User Impact |
| Success Metrics | Success Criteria |
| User Stories (grouped) | Stories list |
| Dependencies | Dependencies |
### What Goes in Epic (FROM TECH SPEC)
| Tech Spec Section | Epic Field |
|-------------------|------------|
| Architecture Overview | Technical Context |
| Technology Choices | Primary Technology |
| Security Requirements | Security notes |
| API Summary | APIs list |
---
## Epic Naming Conventions
### Domain Categories
| Domain | Prefix | Example |
|--------|--------|---------|
| Infrastructure | EPIC-1 | Infrastructure & DevOps |
| Authentication | EPIC-2 | Authentication Service |
| Core Domain 1 | EPIC-3 | {Primary business entity} |
| Core Domain 2 | EPIC-4 | {Secondary business entity} |
| Core Domain N | EPIC-N | {Business capability} |
| Frontend | EPIC-Last | Frontend Application |
### Ordering Principle
```
Infrastructure → Auth → Core Backend (by dependency) → Frontend
```
Always order epics by dependency chain, not alphabetically.
---
## Anti-Patterns to Avoid
| Anti-Pattern | Problem | Solution |
|--------------|---------|----------|
| "EPIC-0: Setup" | Too vague | Split into specific infra tasks |
| "EPIC: Miscellaneous" | Catch-all bucket | Every task belongs to a domain |
| Spec fixes in Epic | Not developer work | Fix source docs directly |
| No dependencies | Unclear execution order | Always specify blocked-by |
| No success criteria | Can't verify completion | Must have testable outcomes |
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: 119k | 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 |