@codihaus/claude-skills 1.6.6 → 1.6.8

package/skills/dev-changelog/SKILL.md

@@ -39,255 +39,101 @@ plans/features/{feature}/
 └── docs-updates.md         # Documentation tasks
 ```
 
-## Workflow
+## Expected Outcome
 
-### Phase 0: Verify Review Passed
+Documentation of what was implemented after `/dev-review` passes.
 
-```
-1. Check: Did /dev-review pass?
-   → Look for review output
-   → Check git for recent review commits
+**Outputs:**
+- `summary.md` - What was built this session/PR
+- `implementation.md` - Cumulative status (updated)
+- `tech-debt.md` - Known issues, TODOs (updated)
+- `docs-updates.md` - Documentation tasks
 
-2. If review not done or failed:
-   → "Run /dev-review first"
-   → Exit
-```
+## Success Criteria
 
-### Phase 1: Gather Sources
+- Changes mapped to specs and use cases
+- Completion status clear (done/partial/not started)
+- Tech debt captured (TODOs, workarounds, gaps)
+- Documentation tasks identified
+- Easy to resume work later
+- Clear what's done, what's remaining
 
-```
-1. Git changes (source of truth)
-   git log --oneline {since}
-   git diff --stat {since}
+## Prerequisite
 
-2. PR/MR info (if available)
-   gh pr view {number}
+**Verify `/dev-review` passed:**
+- If review not done or failed → "Run /dev-review first"
 
-3. Specs (intent)
-   plans/features/{feature}/specs/*.md
+## Sources to Gather
 
-4. Use cases (context)
-   plans/brd/use-cases/{feature}/*.md
+**Git (source of truth):**
+- `git log --oneline {since}` - Commits made
+- `git diff --stat {since}` - Files changed
+- `gh pr view {number}` - PR info (if available)
 
-5. Previous implementation status
-   plans/features/{feature}/implementation.md
-```
+**Intent & Context:**
+- specs/*.md - What was intended
+- use-cases/*.md - Business context
+- implementation.md (previous) - Track cumulative status
 
-### Phase 2: Analyze Changes
+## Analysis
 
-Map git changes to specs and use cases:
+**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:**
+- What component? (API, UI, model, etc.)
+- Which spec item does it fulfill?
+- Which use case does it support?
+- Complete or partial?
 
-| 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 |
+**Extract tech debt:**
+- TODOs in changed files (grep for TODO/FIXME/HACK/XXX)
+- Incomplete spec items (spec says X, implementation does Y)
+- Known issues from commits (WIP, temporary, workaround)
+- Review comments not addressed
 
-### Phase 3: Extract Tech Debt
+**Identify doc updates needed:**
 
-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 |
-|-------------|-------------------|
+| Change Type | Doc Update |
+|-------------|------------|
 | 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)
+## Output Files
 
-```markdown
-# Implementation Status: {Feature}
+**summary.md** (per session/PR):
+- What was built (API, UI, data changes)
+- Spec items completed (with status)
+- Use cases addressed (coverage)
+- Commits list
+- Next steps
 
-> **Last Updated**: {date}
-> **Overall Progress**: 60% (3/5 specs complete)
+**implementation.md** (cumulative):
+- Overall progress percentage
+- Completed items (with PR reference)
+- In progress items (what's done, what's remaining)
+- Not started items (with blockers if any)
+- History (date, PR, summary)
 
-## Completed ✅
+**tech-debt.md** (updated):
+- High/Medium/Low priority issues
+- Location, impact, notes for each
+- Code TODOs with file:line references
 
-| 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 |
+**docs-updates.md** (updated):
+- Required updates (API Reference, User Guide, Configuration)
+- Examples to add (code snippets)
+- Screenshots needed
 
-## 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"}'
-```
+## Resume Flow
 
-### UI Screenshots Needed
-- [ ] Checkout form
-- [ ] Payment success page
-- [ ] Invoice list
-```
+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`
 
 ## Integration with /dev-review