@hustle-together/api-dev-tools 3.11.1 → 3.12.2

package/templates/BRAND_GUIDE.md

@@ -6,53 +6,61 @@
 ## Core Colors
 
 ### Hustle Brand Colors
-| Name | Hex | RGB | Usage |
-|------|-----|-----|-------|
-| **Hustle Red** | #BA0C2F | rgb(186, 12, 47) | Primary accent, buttons, links, focus rings |
-| **Hustle Red Hover** | #8A0923 | rgb(138, 9, 35) | Hover states |
-| **Hustle Red Light** | rgba(186, 12, 47, 0.1) | - | Backgrounds, badges |
+
+| Name                 | Hex                    | RGB              | Usage                                       |
+| -------------------- | ---------------------- | ---------------- | ------------------------------------------- |
+| **Hustle Red**       | #BA0C2F                | rgb(186, 12, 47) | Primary accent, buttons, links, focus rings |
+| **Hustle Red Hover** | #8A0923                | rgb(138, 9, 35)  | Hover states                                |
+| **Hustle Red Light** | rgba(186, 12, 47, 0.1) | -                | Backgrounds, badges                         |
 
 ### Light Mode
-| Name | Hex | Usage |
-|------|-----|-------|
-| **Background** | #FFFFFF | Main background |
-| **Background Secondary** | #F8F8F8 | Cards, sections |
-| **Background Tertiary** | #F0F0F0 | Nested elements |
-| **Text** | #1A1A1A | Primary text |
-| **Text Muted** | #666666 | Secondary text |
-| **Border** | #E5E5E5 | Light borders |
-| **Border Strong** | #000000 | Boxy card borders |
+
+| Name                     | Hex     | Usage             |
+| ------------------------ | ------- | ----------------- |
+| **Background**           | #FFFFFF | Main background   |
+| **Background Secondary** | #F8F8F8 | Cards, sections   |
+| **Background Tertiary**  | #F0F0F0 | Nested elements   |
+| **Text**                 | #1A1A1A | Primary text      |
+| **Text Muted**           | #666666 | Secondary text    |
+| **Border**               | #E5E5E5 | Light borders     |
+| **Border Strong**        | #000000 | Boxy card borders |
 
 ### Dark Mode
-| Name | Hex | Usage |
-|------|-----|-------|
-| **Background** | #050505 | Main background |
+
+| Name                     | Hex     | Usage           |
+| ------------------------ | ------- | --------------- |
+| **Background**           | #050505 | Main background |
 | **Background Secondary** | #111111 | Cards, sections |
-| **Background Tertiary** | #1A1A1A | Nested elements |
-| **Text** | #F0F0F0 | Primary text |
-| **Text Muted** | #888888 | Secondary text |
-| **Border** | #333333 | Dark borders |
+| **Background Tertiary**  | #1A1A1A | Nested elements |
+| **Text**                 | #F0F0F0 | Primary text    |
+| **Text Muted**           | #888888 | Secondary text  |
+| **Border**               | #333333 | Dark borders    |
 
 ### Status Colors
-| Name | Hex | Usage |
-|------|-----|-------|
+
+| Name        | Hex     | Usage                       |
+| ----------- | ------- | --------------------------- |
 | **Success** | #22C55E | Completed, passed, positive |
-| **Warning** | #EAB308 | Caution, pending |
-| **Error** | #EF4444 | Failed, errors, destructive |
-| **Info** | #3B82F6 | Informational |
+| **Warning** | #EAB308 | Caution, pending            |
+| **Error**   | #EF4444 | Failed, errors, destructive |
+| **Info**    | #3B82F6 | Informational               |
 
 ## Typography
 
 ### Font Stack
+
 ```css
 /* Main font */
---font-main: -apple-system, BlinkMacSystemFont, 'SF Pro Text', 'Segoe UI', Roboto, sans-serif;
+--font-main:
+  -apple-system, BlinkMacSystemFont, "SF Pro Text", "Segoe UI", Roboto,
+  sans-serif;
 
 /* Monospace */
---font-mono: 'SF Mono', Monaco, Inconsolata, 'Fira Code', monospace;
+--font-mono: "SF Mono", Monaco, Inconsolata, "Fira Code", monospace;
 ```
 
 ### Font Sizes
+
 - **xs:** 0.75rem (12px)
 - **sm:** 0.875rem (14px)
 - **base:** 1rem (16px)
@@ -65,6 +73,7 @@
 - **6xl:** 4rem (64px)
 
 ### Font Weights
+
 - **Normal:** 400
 - **Medium:** 500
 - **Semibold:** 600
@@ -72,6 +81,7 @@
 - **Extrabold:** 800
 
 ### Line Heights
+
 - **Tight:** 1.1 (headings)
 - **Normal:** 1.5 (body)
 - **Relaxed:** 1.6 (paragraphs)
@@ -79,24 +89,27 @@
 ## Spacing
 
 ### Base Unit
+
 - **Base:** 4px (0.25rem)
 
 ### Scale
-| Token | Value | Pixels |
-|-------|-------|--------|
-| 0 | 0 | 0 |
-| 1 | 0.25rem | 4px |
-| 2 | 0.5rem | 8px |
-| 3 | 0.75rem | 12px |
-| 4 | 1rem | 16px |
-| 5 | 1.25rem | 20px |
-| 6 | 1.5rem | 24px |
-| 8 | 2rem | 32px |
-| 10 | 2.5rem | 40px |
-| 12 | 3rem | 48px |
-| 16 | 4rem | 64px |
+
+| Token | Value   | Pixels |
+| ----- | ------- | ------ |
+| 0     | 0       | 0      |
+| 1     | 0.25rem | 4px    |
+| 2     | 0.5rem  | 8px    |
+| 3     | 0.75rem | 12px   |
+| 4     | 1rem    | 16px   |
+| 5     | 1.25rem | 20px   |
+| 6     | 1.5rem  | 24px   |
+| 8     | 2rem    | 32px   |
+| 10    | 2.5rem  | 40px   |
+| 12    | 3rem    | 48px   |
+| 16    | 4rem    | 64px   |
 
 ### Common Usage
+
 - **Component Padding:** 16px (1rem)
 - **Card Padding:** 24px (1.5rem)
 - **Section Margin:** 32px (2rem)
@@ -105,19 +118,23 @@
 ## Component Styling
 
 ### Design Philosophy
+
 **90s Boxy Style** - Clean, minimal, sharp edges with solid borders.
 
 ### Border Radius
+
 - **Default:** 0 (boxy, no rounding)
 - **Soft:** 4px (subtle rounding for inputs only)
 - **Full:** 9999px (pills, avatars)
 
 ### Border Width
+
 - **Cards:** 2px solid
 - **Inputs:** 2px solid (focus: Hustle Red)
 - **Subtle:** 1px solid
 
 ### Shadows
+
 ```css
 /* Float effect for cards */
 --shadow-float: 0 10px 30px -10px rgba(0, 0, 0, 0.1);
@@ -130,32 +147,37 @@
 ```
 
 ### Focus Ring
+
 ```css
 /* Hustle Red focus ring */
-outline: 2px solid #BA0C2F;
+outline: 2px solid #ba0c2f;
 outline-offset: 2px;
 ```
 
 ### Transitions
+
 ```css
 /* Standard transition */
 transition: all 0.2s ease;
-transition-property: color, background-color, border-color, opacity, transform, box-shadow;
+transition-property:
+  color, background-color, border-color, opacity, transform, box-shadow;
 ```
 
 ## Buttons
 
 ### Primary Button (Hustle Red)
+
 ```css
-background: #BA0C2F;
+background: #ba0c2f;
 color: #ffffff;
 padding: 12px 24px;
-border: 2px solid #BA0C2F;
+border: 2px solid #ba0c2f;
 border-radius: 0;
 font-weight: 700;
 ```
 
 ### Secondary Button
+
 ```css
 background: #ffffff;
 color: #000000;
@@ -166,6 +188,7 @@ font-weight: 700;
 ```
 
 ### Ghost Button
+
 ```css
 background: transparent;
 color: #000000;
@@ -176,20 +199,23 @@ font-weight: 700;
 ```
 
 ### Button Hover States
+
 - **Primary:** background: #8A0923
 - **Secondary:** border-color: #BA0C2F
 - **Ghost:** border-color: #BA0C2F
 
 ### Button Sizes
-| Size | Padding | Font Size |
-|------|---------|-----------|
-| Small | 8px 16px | 12px |
-| Medium | 12px 24px | 14px |
-| Large | 16px 32px | 16px |
+
+| Size   | Padding   | Font Size |
+| ------ | --------- | --------- |
+| Small  | 8px 16px  | 12px      |
+| Medium | 12px 24px | 14px      |
+| Large  | 16px 32px | 16px      |
 
 ## Form Elements
 
 ### Input Fields
+
 ```css
 background: #ffffff;
 border: 2px solid #000000;
@@ -199,11 +225,13 @@ font-size: 14px;
 ```
 
 ### Input States
+
 - **Focus:** `border-color: #BA0C2F;`
 - **Error:** `border-color: #EF4444;`
 - **Disabled:** `background: #F5F5F5; opacity: 0.5;`
 
 ### Labels
+
 ```css
 display: block;
 margin-bottom: 8px;
@@ -214,6 +242,7 @@ font-size: 14px;
 ## Cards
 
 ### Default Card
+
 ```css
 background: #ffffff;
 border: 2px solid #000000;
@@ -222,12 +251,14 @@ padding: 24px;
 ```
 
 ### Card Hover
+
 ```css
-border-color: #BA0C2F;
+border-color: #ba0c2f;
 box-shadow: 4px 4px 0px 0px rgba(186, 12, 47, 0.2);
 ```
 
 ### Card (Dark Mode)
+
 ```css
 background: #111111;
 border: 2px solid #333333;
@@ -236,6 +267,7 @@ border: 2px solid #333333;
 ## Hero Headers
 
 ### Animated Grid Hero
+
 - Height: 450px
 - Canvas-based 3D perspective grid animation
 - Hustle Red accent cells (#BA0C2F)
@@ -246,6 +278,7 @@ border: 2px solid #333333;
 ## Dark Mode Implementation
 
 ### CSS Custom Properties
+
 ```css
 [data-theme="dark"] {
   --bg: #050505;
@@ -257,20 +290,24 @@ border: 2px solid #333333;
 ```
 
 ### Tailwind Classes
+
 Use `dark:` prefix for all dark mode styles:
+
 ```html
-<div class="bg-white dark:bg-gray-900 text-black dark:text-white">
+<div class="bg-white dark:bg-gray-900 text-black dark:text-white"></div>
 ```
 
 ## Voice & Tone
 
 ### Writing Style
+
 - **Professional** but approachable
 - **Clear** and concise
 - **Technical precision** - no fluff
 - **No emojis** in code or documentation (unless requested)
 
 ### UI Copy Guidelines
+
 - Use active voice
 - Keep button labels to 2-3 words
 - Error messages should explain how to fix the issue
@@ -279,16 +316,19 @@ Use `dark:` prefix for all dark mode styles:
 ## Accessibility Requirements
 
 ### Color Contrast
+
 - **Normal Text:** Minimum 4.5:1 ratio (WCAG AA)
 - **Large Text:** Minimum 3:1 ratio
 - **Interactive Elements:** Minimum 3:1 ratio
 
 ### Focus Indicators
+
 - All interactive elements must have visible focus states
 - Hustle Red (#BA0C2F) focus ring
 - Focus should not be removed or hidden
 
 ### Touch Targets
+
 - Minimum size: 44px x 44px
 - Minimum spacing: 8px between targets
 

package/templates/CLAUDE-SECTION.md

@@ -4,16 +4,16 @@ This project uses **@hustle-together/api-dev-tools** for interview-driven, resea
 
 ### Available Commands
 
-| Command | Purpose |
-|---------|---------|
-| `/hustle-api-create [endpoint]` | Complete 13-phase workflow |
-| `/hustle-api-interview [endpoint]` | Questions FROM research findings |
-| `/hustle-api-research [library]` | Adaptive propose-approve research |
-| `/hustle-api-verify [endpoint]` | Re-research and verify implementation |
-| `/hustle-api-env [endpoint]` | Check API keys |
-| `/hustle-api-status [endpoint]` | Track progress |
-| `/hustle-api-continue [endpoint]` | Resume interrupted workflow |
-| `/hustle-api-sessions` | Browse saved session logs |
+| Command                            | Purpose                               |
+| ---------------------------------- | ------------------------------------- |
+| `/hustle-api-create [endpoint]`    | Complete 13-phase workflow            |
+| `/hustle-api-interview [endpoint]` | Questions FROM research findings      |
+| `/hustle-api-research [library]`   | Adaptive propose-approve research     |
+| `/hustle-api-verify [endpoint]`    | Re-research and verify implementation |
+| `/hustle-api-env [endpoint]`       | Check API keys                        |
+| `/hustle-api-status [endpoint]`    | Track progress                        |
+| `/hustle-api-continue [endpoint]`  | Resume interrupted workflow           |
+| `/hustle-api-sessions`             | Browse saved session logs             |
 
 ### 13-Phase Flow
 
@@ -44,6 +44,7 @@ Phase 13: COMPLETION         - Final verification, commit
 ### State Tracking
 
 All progress is tracked in `.claude/api-dev-state.json`:
+
 - Current phase and status for each endpoint
 - Interview decisions (injected during implementation)
 - Research sources with freshness tracking
@@ -53,6 +54,7 @@ All progress is tracked in `.claude/api-dev-state.json`:
 ### Research Cache
 
 Research is cached in `.claude/research/` with 7-day freshness:
+
 - `index.json` - Freshness tracking
 - `[api-name]/CURRENT.md` - Latest research
 - `[api-name]/sources.json` - Research sources
@@ -62,37 +64,38 @@ Research is cached in `.claude/research/` with 7-day freshness:
 
 ### Hooks (25 Total - Automatic Enforcement)
 
-| Hook | Event | Action |
-|------|-------|--------|
-| `session-startup.py` | SessionStart | Inject state context |
-| `detect-interruption.py` | SessionStart | Detect interrupted workflows |
-| `enforce-external-research.py` | UserPromptSubmit | Require research first |
-| `enforce-disambiguation.py` | PreToolUse | Phase 1 enforcement |
-| `enforce-scope.py` | PreToolUse | Phase 2 enforcement |
-| `enforce-research.py` | PreToolUse | Phase 3 enforcement |
-| `enforce-interview.py` | PreToolUse | Phase 4 - inject decisions |
-| `enforce-deep-research.py` | PreToolUse | Phase 5 enforcement |
-| `enforce-schema.py` | PreToolUse | Phase 6 enforcement |
-| `enforce-environment.py` | PreToolUse | Phase 7 enforcement |
-| `enforce-tdd-red.py` | PreToolUse | Phase 8 enforcement |
-| `verify-implementation.py` | PreToolUse | Phase 9 helper |
-| `enforce-verify.py` | PreToolUse | Phase 10 enforcement |
-| `enforce-refactor.py` | PreToolUse | Phase 11 enforcement |
-| `enforce-documentation.py` | PreToolUse | Phase 12 enforcement |
-| `enforce-questions-sourced.py` | PreToolUse | Validate questions from research |
-| `enforce-schema-from-interview.py` | PreToolUse | Validate schema from interview |
-| `track-tool-use.py` | PostToolUse | Log research, count turns |
-| `periodic-reground.py` | PostToolUse | Re-inject context every 7 turns |
-| `track-scope-coverage.py` | PostToolUse | Track implemented vs deferred |
-| `verify-after-green.py` | PostToolUse | Trigger Phase 10 after tests pass |
-| `cache-research.py` | PostToolUse | Create research cache files |
-| `generate-manifest-entry.py` | PostToolUse | Auto-generate API documentation |
-| `api-workflow-check.py` | Stop | Block if incomplete, generate output |
-| `session-logger.py` | Stop | Save session to api-sessions |
+| Hook                               | Event            | Action                               |
+| ---------------------------------- | ---------------- | ------------------------------------ |
+| `session-startup.py`               | SessionStart     | Inject state context                 |
+| `detect-interruption.py`           | SessionStart     | Detect interrupted workflows         |
+| `enforce-external-research.py`     | UserPromptSubmit | Require research first               |
+| `enforce-disambiguation.py`        | PreToolUse       | Phase 1 enforcement                  |
+| `enforce-scope.py`                 | PreToolUse       | Phase 2 enforcement                  |
+| `enforce-research.py`              | PreToolUse       | Phase 3 enforcement                  |
+| `enforce-interview.py`             | PreToolUse       | Phase 4 - inject decisions           |
+| `enforce-deep-research.py`         | PreToolUse       | Phase 5 enforcement                  |
+| `enforce-schema.py`                | PreToolUse       | Phase 6 enforcement                  |
+| `enforce-environment.py`           | PreToolUse       | Phase 7 enforcement                  |
+| `enforce-tdd-red.py`               | PreToolUse       | Phase 8 enforcement                  |
+| `verify-implementation.py`         | PreToolUse       | Phase 9 helper                       |
+| `enforce-verify.py`                | PreToolUse       | Phase 10 enforcement                 |
+| `enforce-refactor.py`              | PreToolUse       | Phase 11 enforcement                 |
+| `enforce-documentation.py`         | PreToolUse       | Phase 12 enforcement                 |
+| `enforce-questions-sourced.py`     | PreToolUse       | Validate questions from research     |
+| `enforce-schema-from-interview.py` | PreToolUse       | Validate schema from interview       |
+| `track-tool-use.py`                | PostToolUse      | Log research, count turns            |
+| `periodic-reground.py`             | PostToolUse      | Re-inject context every 7 turns      |
+| `track-scope-coverage.py`          | PostToolUse      | Track implemented vs deferred        |
+| `verify-after-green.py`            | PostToolUse      | Trigger Phase 10 after tests pass    |
+| `cache-research.py`                | PostToolUse      | Create research cache files          |
+| `generate-manifest-entry.py`       | PostToolUse      | Auto-generate API documentation      |
+| `api-workflow-check.py`            | Stop             | Block if incomplete, generate output |
+| `session-logger.py`                | Stop             | Save session to api-sessions         |
 
 ### Auto-Generated Documentation
 
 When Phase 12 completes, `generate-manifest-entry.py` automatically creates:
+
 - **Comprehensive curl examples** (minimal, full, auth, enum variations, boundary values)
 - **Complete test cases** (success, validation, required fields, types, boundaries, arrays)
 - **Parameter documentation** with all possible values