@codihaus/claude-skills 1.0.0

package/skills/dev-changelog/SKILL.md

@@ -0,0 +1,378 @@
+---
+name: dev-changelog
+description: Capture implementation summary, track progress, identify docs updates
+version: 1.0.0
+---
+
+# /dev-changelog - Implementation Summary
+
+> **Skill Awareness**: See `skills/_registry.md` for all available skills.
+> - **Before**: `/dev-review` passes (code is good)
+> - **Reads**: Git changes, specs, use cases
+> - **Outputs**: Summary of what was built, what's left, docs to update
+
+Capture what was implemented after review passes. Creates actionable documentation.
+
+## When to Use
+
+- After `/dev-review` passes
+- End of sprint/milestone
+- Before handoff to another developer
+- When you need to resume work later
+
+## Usage
+
+```
+/dev-changelog billing              # Summarize billing feature work
+/dev-changelog --since=v1.0.0       # Changes since tag
+/dev-changelog --since=2024-01-01   # Changes since date
+/dev-changelog --pr=123             # Changes in specific PR
+```
+
+## Output
+
+```
+plans/features/{feature}/
+├── summary.md              # What was built (this session/PR)
+├── implementation.md       # Cumulative implementation status
+├── tech-debt.md            # Known issues, TODOs
+└── docs-updates.md         # Documentation tasks
+```
+
+## Workflow
+
+### Phase 0: Verify Review Passed
+
+```
+1. Check: Did /dev-review pass?
+   → Look for review output
+   → Check git for recent review commits
+
+2. If review not done or failed:
+   → "Run /dev-review first"
+   → Exit
+```
+
+### Phase 1: Gather Sources
+
+```
+1. Git changes (source of truth)
+   git log --oneline {since}
+   git diff --stat {since}
+
+2. PR/MR info (if available)
+   gh pr view {number}
+
+3. Specs (intent)
+   plans/features/{feature}/specs/*.md
+
+4. Use cases (context)
+   plans/brd/use-cases/{feature}/*.md
+
+5. Previous implementation status
+   plans/features/{feature}/implementation.md
+```
+
+### Phase 2: Analyze Changes
+
+Map git changes to specs and use cases:
+
+```
+For each changed file:
+1. What component is this? (API, UI, model, etc.)
+2. Which spec item does it fulfill?
+3. Which use case does it support?
+4. Is it complete or partial?
+```
+
+**Mapping table:**
+
+| File Changed | Type | Spec Item | Use Case | Status |
+|--------------|------|-----------|----------|--------|
+| `api/billing/checkout.ts` | API | SPEC-PAY-001 | UC-PAY-001 | Complete |
+| `components/CheckoutForm.tsx` | UI | SPEC-PAY-001 | UC-PAY-001 | Complete |
+| `api/billing/subscription.ts` | API | SPEC-PAY-004 | UC-PAY-002 | Partial |
+
+### Phase 3: Extract Tech Debt
+
+Scan for incomplete items:
+
+```
+1. TODOs in changed files
+   grep -r "TODO\|FIXME\|HACK\|XXX" {changed_files}
+
+2. Incomplete spec items
+   → Spec says X, implementation does Y
+
+3. Known issues from commits
+   → "WIP:", "temporary", "workaround"
+
+4. Review comments not addressed
+   → From /dev-review output
+```
+
+### Phase 4: Identify Documentation Updates
+
+Based on what changed:
+
+| Change Type | Doc Update Needed |
+|-------------|-------------------|
+| New API endpoint | API Reference |
+| New UI feature | User Guide |
+| New config option | Configuration docs |
+| Breaking change | Migration guide |
+| New component | Component docs |
+
+### Phase 5: Generate Outputs
+
+#### summary.md (per session/PR)
+
+```markdown
+# Summary: {Feature} - {Date/PR}
+
+> **PR**: #{number} or commit range
+> **Author**: {who}
+> **Review**: Passed
+
+## What Was Built
+
+### API Changes
+- `POST /api/billing/checkout` - Process payment
+- `GET /api/billing/invoices` - List invoices
+
+### UI Changes
+- CheckoutForm component
+- InvoiceList component
+- PaymentSuccess page
+
+### Data Changes
+- Added Invoice model
+- Added Payment model
+- Migration: 20240118_add_billing_tables
+
+## Spec Items Completed
+
+| Spec | Title | Status |
+|------|-------|--------|
+| SPEC-PAY-001 | Checkout Flow | ✅ Complete |
+| SPEC-PAY-002 | Payment Processing | ✅ Complete |
+| SPEC-PAY-004 | Subscription Mgmt | ⚠️ Partial |
+
+## Use Cases Addressed
+
+| UC | Title | Coverage |
+|----|-------|----------|
+| UC-PAY-001 | Checkout | Full |
+| UC-PAY-002 | Subscribe | Create only |
+
+## Commits
+
+- `abc1234` feat(billing): add checkout endpoint
+- `def5678` feat(billing): add CheckoutForm component
+- `ghi9012` feat(billing): add invoice model
+
+## Next Steps
+
+1. Complete subscription upgrade/downgrade (SPEC-PAY-004)
+2. Add refund functionality (SPEC-PAY-005)
+3. Update API documentation
+```
+
+#### implementation.md (cumulative status)
+
+```markdown
+# Implementation Status: {Feature}
+
+> **Last Updated**: {date}
+> **Overall Progress**: 60% (3/5 specs complete)
+
+## Completed ✅
+
+| Item | Spec | UC | Implemented In |
+|------|------|----|----------------|
+| Checkout | SPEC-PAY-001 | UC-PAY-001 | PR #123 |
+| Payments | SPEC-PAY-002 | UC-PAY-001 | PR #123 |
+| Invoices | SPEC-PAY-003 | UC-PAY-003 | PR #125 |
+
+## In Progress ⚠️
+
+| Item | Spec | UC | Done | Remaining |
+|------|------|----|------|-----------|
+| Subscriptions | SPEC-PAY-004 | UC-PAY-002 | Create/cancel | Upgrade/downgrade |
+
+## Not Started ❌
+
+| Item | Spec | UC | Blocked By |
+|------|------|----|------------|
+| Refunds | SPEC-PAY-005 | UC-PAY-004 | - |
+| Usage billing | SPEC-PAY-006 | UC-PAY-005 | Phase 2 |
+
+## History
+
+| Date | PR | Summary |
+|------|----|---------|
+| 2024-01-18 | #123 | Checkout + payments |
+| 2024-01-20 | #125 | Invoice generation |
+```
+
+#### tech-debt.md
+
+```markdown
+# Tech Debt: {Feature}
+
+> **Last Updated**: {date}
+
+## High Priority
+
+| Issue | Location | Impact | Notes |
+|-------|----------|--------|-------|
+| No retry on payment failure | `billing/stripe.ts:45` | Users see errors | Add exponential backoff |
+
+## Medium Priority
+
+| Issue | Location | Impact | Notes |
+|-------|----------|--------|-------|
+| Hardcoded tax rate | `billing/invoice.ts:23` | Wrong tax for some regions | Make configurable |
+| No pagination | `api/invoices.ts:12` | Slow for many invoices | Add cursor pagination |
+
+## Low Priority
+
+| Issue | Location | Impact | Notes |
+|-------|----------|--------|-------|
+| TODO: Add logging | `billing/checkout.ts:78` | Hard to debug | Add structured logging |
+
+## Code TODOs
+
+```
+billing/stripe.ts:45: TODO: Add retry logic for failed payments
+billing/invoice.ts:23: TODO: Make tax rate configurable
+billing/checkout.ts:78: TODO: Add logging
+```
+```
+
+#### docs-updates.md
+
+```markdown
+# Documentation Updates: {Feature}
+
+> **Last Updated**: {date}
+
+## Required Updates
+
+### API Reference
+- [ ] Add `POST /api/billing/checkout` endpoint
+- [ ] Add `GET /api/billing/invoices` endpoint
+- [ ] Add `POST /api/billing/subscriptions` endpoint
+
+### User Guide
+- [ ] Add "Making a Purchase" section
+- [ ] Add "Managing Your Subscription" section
+- [ ] Add "Viewing Invoices" section
+
+### Configuration
+- [ ] Document `STRIPE_SECRET_KEY` env var
+- [ ] Document `STRIPE_WEBHOOK_SECRET` env var
+
+## Examples to Add
+
+### API Examples
+```bash
+# Checkout
+curl -X POST /api/billing/checkout \
+  -H "Authorization: Bearer {token}" \
+  -d '{"planId": "pro", "paymentMethodId": "pm_xxx"}'
+```
+
+### UI Screenshots Needed
+- [ ] Checkout form
+- [ ] Payment success page
+- [ ] Invoice list
+```
+
+## Integration with /dev-review
+
+When `/dev-review` completes successfully:
+
+```
+/dev-review output:
+├── quality-report.md (existing)
+└── Suggests: "Run /dev-changelog to document what was built"
+
+Then:
+/dev-changelog
+├── Reads review output
+├── Reads git changes
+├── Generates summary.md, implementation.md, etc.
+```
+
+## Resume Flow
+
+When returning to work later:
+
+```
+1. Read implementation.md
+   → See what's done, what's remaining
+
+2. Read tech-debt.md
+   → See known issues
+
+3. Read summary.md (latest)
+   → See where you left off
+
+4. Continue with /dev-specs or /dev-coding
+```
+
+## Tools Used
+
+| Tool | Purpose |
+|------|---------|
+| `Bash` | Git log, diff, grep for TODOs |
+| `Read` | Specs, use cases, previous status |
+| `Write` | Output files |
+| `Grep` | Find TODOs in code |
+
+## Example Flow
+
+```
+User: /dev-changelog billing
+
+1. Verify review
+   → Found: plans/features/billing/review-report.md (passed)
+
+2. Gather sources
+   → Git: 5 commits since last changelog
+   → Specs: SPEC-PAY-001 to 006
+   → UCs: UC-PAY-001 to 005
+
+3. Analyze changes
+   → 3 API files changed
+   → 4 UI files changed
+   → 2 new models
+
+4. Map to specs
+   → SPEC-PAY-001: Complete (checkout)
+   → SPEC-PAY-002: Complete (payments)
+   → SPEC-PAY-004: Partial (subscriptions)
+
+5. Extract tech debt
+   → 3 TODOs found
+   → 1 incomplete spec item
+
+6. Identify doc updates
+   → 3 new endpoints need docs
+   → 2 new UI features need guide
+
+7. Generate outputs
+   → summary.md
+   → implementation.md (updated)
+   → tech-debt.md (updated)
+   → docs-updates.md
+
+Output:
+"Documented billing implementation:
+ - 2 specs complete, 1 partial
+ - 3 tech debt items
+ - 6 doc updates needed
+
+ See: plans/features/billing/summary.md"
+```