e8d68685c1
- Add /gsd:research-phase command for comprehensive ecosystem research - Rename FINDINGS.md → DISCOVERY.md for clarity - Rename research-phase.md → discovery-phase.md (shallow "which library") - New research-phase.md for deep "how experts build this" research - Creates RESEARCH.md with stack, patterns, pitfalls, don't-hand-roll - plan-phase loads RESEARCH.md when present 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
Git integration for GSD framework.
## Phase Completion
## Handoff (WIP)
<core_principle>
Commit outcomes, not process.
The git log should read like a changelog of what shipped, not a diary of planning activity. </core_principle>
<commit_points>
| Event | Commit? | Why |
|---|---|---|
| BRIEF + ROADMAP created | YES | Project initialization |
| PLAN.md created | NO | Intermediate - commit with completion |
| RESEARCH.md created | NO | Intermediate |
| DISCOVERY.md created | NO | Intermediate |
| Phase completed | YES | Actual code shipped |
| Handoff created | YES | WIP state preserved |
</commit_points>
<git_check>
[ -d .git ] && echo "GIT_EXISTS" || echo "NO_GIT"
If NO_GIT: Run git init silently. GSD projects always get their own repo.
</git_check>
<commit_formats>
## Project Initialization (brief + roadmap together)docs: initialize [project-name] ([N] phases)
[One-liner from PROJECT.md]
Phases:
1. [phase-name]: [goal]
2. [phase-name]: [goal]
3. [phase-name]: [goal]
What to commit:
git add .planning/
git commit
feat([domain]): [one-liner from SUMMARY.md]
- [Key accomplishment 1]
- [Key accomplishment 2]
- [Key accomplishment 3]
[If issues encountered:]
Note: [issue and resolution]
Use fix([domain]) for bug fix phases.
What to commit:
git add .planning/phases/XX-name/ # PLAN.md + SUMMARY.md
git add src/ # Actual code created
git commit
wip: [phase-name] paused at task [X]/[Y]
Current: [task name]
[If blocked:] Blocked: [reason]
What to commit:
git add .planning/
git commit
<example_log>
a]7f2d1 feat(checkout): Stripe payments with webhook verification
b]3e9c4 feat(products): catalog with search, filters, and pagination
c]8a1b2 feat(auth): JWT with refresh rotation using jose
d]5c3d7 feat(foundation): Next.js 15 + Prisma + Tailwind scaffold
e]2f4a8 docs: initialize ecommerce-app (5 phases)
</example_log>
<anti_patterns>
- PLAN.md creation (wait for phase completion)
- RESEARCH.md (intermediate)
- DISCOVERY.md (intermediate)
- Minor planning tweaks
- "Fixed typo in roadmap"
These create noise. Commit outcomes, not process. </anti_patterns>