feat: Add self-contained orchestration templates and guide
Some checks failed
ci/woodpecker/push/woodpecker Pipeline failed
Some checks failed
ci/woodpecker/push/woodpecker Pipeline failed
Makes Mosaic Stack self-contained for orchestration - no external dependencies. New files: - docs/claude/orchestrator.md - Platform-specific orchestrator protocol - docs/templates/ - Bootstrap templates for tasks.md, learnings, reports Templates: - orchestrator/tasks.md.template - Task tracking scaffold - orchestrator/orchestrator-learnings.json.template - Variance tracking - orchestrator/orchestrator-learnings.schema.md - JSON schema docs - orchestrator/phase-issue-body.md.template - Gitea issue body - orchestrator/compaction-summary.md.template - 60% checkpoint format - reports/review-report-scaffold.sh - Creates report directory - scratchpad.md.template - Per-task working document Updated CLAUDE.md: - References local docs/claude/orchestrator.md instead of ~/.claude/ - Added Platform Templates section pointing to docs/templates/ This enables deployment without requiring user-level ~/.claude/ configuration. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
92
docs/templates/scratchpad.md.template
vendored
Normal file
92
docs/templates/scratchpad.md.template
vendored
Normal file
@@ -0,0 +1,92 @@
|
||||
# Issue #${ISSUE_NUMBER}: ${ISSUE_TITLE}
|
||||
|
||||
**Project:** ${PROJECT}
|
||||
**Milestone:** ${MILESTONE}
|
||||
**Task ID:** ${TASK_ID}
|
||||
**Started:** ${CURRENT_DATETIME}
|
||||
**Agent:** ${AGENT_ID}
|
||||
|
||||
---
|
||||
|
||||
## Objective
|
||||
|
||||
${TASK_DESCRIPTION}
|
||||
|
||||
**Finding reference:** See `docs/reports/` for detailed finding (search for ${FINDING_ID})
|
||||
|
||||
---
|
||||
|
||||
## Approach
|
||||
|
||||
### Analysis
|
||||
|
||||
<!-- Initial analysis of what needs to be done -->
|
||||
|
||||
### Implementation Plan
|
||||
|
||||
1. [ ] Step 1
|
||||
2. [ ] Step 2
|
||||
3. [ ] Step 3
|
||||
|
||||
### Files to Modify
|
||||
|
||||
| File | Change |
|
||||
|------|--------|
|
||||
| `path/to/file.ts` | Description |
|
||||
|
||||
---
|
||||
|
||||
## Progress
|
||||
|
||||
### ${CURRENT_DATE}
|
||||
|
||||
- [ ] Implementation started
|
||||
- [ ] Tests written
|
||||
- [ ] Quality gates passing
|
||||
|
||||
---
|
||||
|
||||
## Testing
|
||||
|
||||
### Commands
|
||||
|
||||
```bash
|
||||
# Run relevant tests
|
||||
pnpm test --filter=@app/component
|
||||
pnpm lint
|
||||
pnpm typecheck
|
||||
```
|
||||
|
||||
### Manual Verification
|
||||
|
||||
- [ ] Feature works as expected
|
||||
- [ ] No regressions introduced
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
### Decisions Made
|
||||
|
||||
<!-- Document key decisions and rationale -->
|
||||
|
||||
### Blockers Encountered
|
||||
|
||||
<!-- Document any blockers and how resolved -->
|
||||
|
||||
### Learnings
|
||||
|
||||
<!-- Document learnings for orchestrator-learnings.json -->
|
||||
|
||||
---
|
||||
|
||||
## Completion Checklist
|
||||
|
||||
- [ ] Implementation complete
|
||||
- [ ] All tests passing
|
||||
- [ ] Quality gates pass (lint, typecheck)
|
||||
- [ ] Committed with proper message
|
||||
- [ ] tasks.md updated (by orchestrator)
|
||||
|
||||
**Completed:**
|
||||
**Actual tokens:** K
|
||||
Reference in New Issue
Block a user