Skip to content

Commit aeed872

Browse files
KevenWMarkhamclaude
KevenWMarkham
and
claude
committed
docs(orchestration): add project kickoff and testing session prompts
- Create KICKOFF_ORCHESTRATION_PROMPT.md with interface recommendations - Claude Web (Opus) for planning/orchestration - Claude Code CLI (Sonnet/Opus) for implementation - Claude Code Client (Opus) for code review - Create SESSION_TESTING_PROMPT.md for Epic 01 completion - Unit test coverage targets (80%) - E2E test critical flows (5 flows) - Expert checklists (Testing, Security) - Document orchestration workflow and NO CODE policy Sprint: epic-01/sprint-01 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 98cb441 commit aeed872

File tree

2 files changed

+439
-0
lines changed

2 files changed

+439
-0
lines changed

‎specs/KICKOFF_ORCHESTRATION_PROMPT.md‎

Lines changed: 230 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,230 @@
1+
# SmartHaven AI Platform - Orchestration Kickoff
2+
3+
**Date**: December 23, 2024
4+
**Orchestrator**: Claude (NO CODE Policy)
5+
**Project Status**: Epic 01 Sprint 01 - 85% Complete
6+
7+
---
8+
9+
## Claude Interface Recommendations
10+
11+
### Interface Selection Matrix
12+
13+
| Task Type | Interface | Model | Rationale |
14+
| ---------------------------- | ------------------------ | ----------- | --------------------------------- |
15+
| **Orchestration & Planning** | Claude Web | Opus | Collaborative, strategic thinking |
16+
| **Sprint Kickoff** | Claude Web | Opus | High-level coordination |
17+
| **Session Prompts Creation** | Claude Code CLI | Sonnet | File management needed |
18+
| **Code Implementation** | Claude Code CLI | Sonnet/Opus | Local dev environment |
19+
| **Code Review** | Claude Code Client (IDE) | Opus | Deep analysis with context |
20+
| **Testing Sessions** | Claude Code CLI | Sonnet | Execute and iterate |
21+
| **Documentation** | Claude Web | Sonnet | Content generation |
22+
| **Architecture Decisions** | Claude Web | Opus | Complex reasoning |
23+
24+
### Recommended Workflow
25+
26+
```
27+
┌─────────────────────────────────────────────────────────────────────────┐
28+
│ ORCHESTRATION WORKFLOW │
29+
├─────────────────────────────────────────────────────────────────────────┤
30+
│ │
31+
│ STEP 1: PLANNING (Claude Web - Opus) │
32+
│ ├── Review ROADMAP.md and current sprint status │
33+
│ ├── Define sessions and tasks │
34+
│ ├── Assign experts │
35+
│ └── Output: Session prompts ready for execution │
36+
│ │
37+
│ STEP 2: SESSION EXECUTION (Claude Code CLI - Sonnet/Opus) │
38+
│ ├── Load SESSION_XX_PROMPT.md │
39+
│ ├── Implement assigned tasks │
40+
│ ├── Get expert feedback │
41+
│ └── Auto-commit after each session │
42+
│ │
43+
│ STEP 3: REVIEW (Claude Code Client - Opus) │
44+
│ ├── Code review in IDE │
45+
│ ├── Architecture validation │
46+
│ └── Security audit │
47+
│ │
48+
│ STEP 4: VALIDATION (Claude Code CLI - Sonnet) │
49+
│ ├── Run all tests │
50+
│ ├── Demo in Development │
51+
│ ├── Demo in Production │
52+
│ └── Sprint sign-off │
53+
│ │
54+
└─────────────────────────────────────────────────────────────────────────┘
55+
```
56+
57+
---
58+
59+
## Current Status Assessment
60+
61+
### Epic 01: Monorepo Foundation - Sprint 01
62+
63+
**Progress**: 85% Complete
64+
65+
**Completed**:
66+
67+
- [x] Package extraction (8 packages)
68+
- [x] Turborepo + pnpm workspaces
69+
- [x] Module SDK architecture
70+
- [x] Core component migration
71+
- [x] AI services integration
72+
- [x] Database package setup
73+
- [x] Export functionality
74+
- [x] Build system configuration
75+
76+
**Remaining**:
77+
78+
- [ ] Unit testing completion (target: 80% coverage)
79+
- [ ] E2E testing (5 critical flows)
80+
- [ ] Final validation and demo
81+
- [ ] Sprint sign-off
82+
83+
---
84+
85+
## Kickoff Session Plan
86+
87+
### Session 1: Testing Completion (Claude Code CLI - Sonnet)
88+
89+
**Objective**: Complete unit and E2E testing to reach sprint completion
90+
91+
**Tasks**:
92+
93+
1. Run existing tests and identify gaps
94+
2. Add missing unit tests for critical paths
95+
3. Execute E2E tests for 5 critical user flows
96+
4. Fix any failing tests
97+
5. Generate coverage report
98+
99+
**Expert Requirements**:
100+
101+
- Testing Expert: Coverage strategy, edge cases
102+
- Security Expert: Auth flow testing
103+
104+
**Acceptance Criteria**:
105+
106+
- [ ] Unit test coverage ≥ 80%
107+
- [ ] All E2E tests passing
108+
- [ ] No critical security issues
109+
110+
---
111+
112+
### Session 2: Demo & Validation (Claude Code CLI - Sonnet)
113+
114+
**Objective**: Validate sprint deliverables in both environments
115+
116+
**Tasks**:
117+
118+
1. Deploy to Development environment
119+
2. Run smoke tests
120+
3. Demo all sprint features
121+
4. Deploy to Production (PromptSource.live)
122+
5. Verify production functionality
123+
124+
**Expert Requirements**:
125+
126+
- Architecture Expert: Deployment validation
127+
- Performance Expert: Load testing basics
128+
129+
**Acceptance Criteria**:
130+
131+
- [ ] Dev demo working
132+
- [ ] Prod demo working
133+
- [ ] All acceptance criteria met
134+
135+
---
136+
137+
### Session 3: Sprint Sign-off (Claude Web - Opus)
138+
139+
**Objective**: Complete sprint documentation and transition to Epic 02
140+
141+
**Tasks**:
142+
143+
1. Complete SIGN_OFF.md
144+
2. Update ROADMAP.md progress
145+
3. Create Epic 02 Sprint 01 planning documents
146+
4. Define first sessions for Epic 02
147+
148+
**Expert Requirements**:
149+
150+
- Architecture Expert: Epic 02 technical approach
151+
- Security Expert: Auth system design review
152+
153+
**Acceptance Criteria**:
154+
155+
- [ ] Sprint 01 signed off
156+
- [ ] Epic 02 Sprint 01 planned
157+
- [ ] First session prompts ready
158+
159+
---
160+
161+
## Expert Panel for Sprint Completion
162+
163+
| Expert | Focus Area | Sessions |
164+
| ---------------- | ------------------------------------- | -------- |
165+
| **Testing** | Coverage, E2E flows, edge cases | 1, 2 |
166+
| **Security** | Auth testing, deployment security | 1, 2 |
167+
| **Architecture** | Deployment validation, Epic 02 design | 2, 3 |
168+
| **Performance** | Build optimization, load basics | 2 |
169+
170+
---
171+
172+
## Orchestrator Instructions
173+
174+
### For This Kickoff
175+
176+
1. **Read this prompt** in Claude Web (Opus)
177+
2. **Review** current test coverage and E2E status
178+
3. **Create** SESSION_01_TESTING_PROMPT.md for the Testing session
179+
4. **Execute** Session 1 in Claude Code CLI
180+
5. **Iterate** until testing complete
181+
6. **Continue** to Session 2 and 3
182+
183+
### NO CODE Policy Reminder
184+
185+
The Orchestrator (you, in Claude Web):
186+
187+
- **DOES**: Plan, coordinate, create prompts, review, validate
188+
- **DOES NOT**: Write implementation code directly
189+
190+
All code implementation happens in Claude Code CLI sessions.
191+
192+
---
193+
194+
## Next Action
195+
196+
**Recommended**: Start Session 1 (Testing Completion)
197+
198+
**Interface**: Claude Code CLI
199+
**Model**: Sonnet (cost-effective for testing tasks)
200+
**Prompt Location**: Create `specs/epics/epic-01-monorepo-foundation/sprints/sprint-01/implementation/SESSION_TESTING_PROMPT.md`
201+
202+
---
203+
204+
## Quick Start Commands
205+
206+
```bash
207+
# Check current test status
208+
cd C:\code\transcript-parser
209+
pnpm test
210+
pnpm test:coverage
211+
212+
# Check E2E status
213+
pnpm test:e2e
214+
215+
# View current sprint files
216+
ls specs/epics/epic-01-monorepo-foundation/sprints/sprint-01/
217+
```
218+
219+
---
220+
221+
## Related Documents
222+
223+
- [ROADMAP.md](./ROADMAP.md) - Product roadmap
224+
- [ORCHESTRATION.md](./ORCHESTRATION.md) - Development workflow
225+
- [NAMING_CONVENTIONS.md](./NAMING_CONVENTIONS.md) - Standards
226+
- [Sprint 01 Overview](./epics/epic-01-monorepo-foundation/sprints/sprint-01/Sprint%2001%20-%20Overview.md)
227+
228+
---
229+
230+
**Orchestrator Acknowledgment**: Ready to begin kickoff sequence.

0 commit comments

Comments
 (0)