get-shit-done-cc 1.9.11 → 1.10.0-experimental.0

package/get-shit-done/templates/design-system.md

@@ -0,0 +1,238 @@
+---
+name: design-system-template
+description: Template for project-wide design system documentation
+used_by:
+  - design-system
+placeholders:
+  - project_name
+  - aesthetic_summary
+  - color_palette
+  - typography
+  - spacing
+  - components
+  - patterns
+---
+
+<template>
+
+# Design System
+
+**Project:** {project_name}
+**Framework:** {framework}
+**Created:** {date}
+
+## Aesthetic Direction
+
+{aesthetic_summary}
+
+{?inspiration}
+### Visual References
+
+{inspiration_description}
+
+{/inspiration}
+
+---
+
+## Color Palette
+
+### Brand Colors
+
+| Name | Value | Usage |
+|------|-------|-------|
+{brand_colors}
+
+### Semantic Colors
+
+| Purpose | Light Mode | Dark Mode |
+|---------|------------|-----------|
+| Success | {success_light} | {success_dark} |
+| Warning | {warning_light} | {warning_dark} |
+| Error | {error_light} | {error_dark} |
+| Info | {info_light} | {info_dark} |
+
+### Neutral Scale
+
+```
+{neutral_scale}
+```
+
+---
+
+## Typography
+
+### Font Stack
+
+**Primary:** {font_primary}
+**Monospace:** {font_mono}
+
+### Type Scale
+
+| Name | Size | Weight | Line Height | Usage |
+|------|------|--------|-------------|-------|
+{type_scale}
+
+### Text Styles
+
+{text_styles}
+
+---
+
+## Spacing
+
+### Base Unit
+
+{spacing_base}
+
+### Scale
+
+```
+{spacing_scale}
+```
+
+### Common Spacing Patterns
+
+| Context | Value |
+|---------|-------|
+{spacing_patterns}
+
+---
+
+## Components
+
+### Buttons
+
+{button_specs}
+
+### Inputs
+
+{input_specs}
+
+### Cards
+
+{card_specs}
+
+{?additional_components}
+### Additional Components
+
+{additional_components}
+{/additional_components}
+
+---
+
+## Layout
+
+### Breakpoints
+
+| Name | Width | Usage |
+|------|-------|-------|
+{breakpoints}
+
+### Grid
+
+{grid_specs}
+
+### Content Width
+
+{content_width}
+
+---
+
+## Interaction
+
+### Transitions
+
+| Type | Duration | Easing |
+|------|----------|--------|
+{transitions}
+
+### Feedback Patterns
+
+{feedback_patterns}
+
+---
+
+## Accessibility
+
+### Contrast Requirements
+
+{contrast_requirements}
+
+### Focus States
+
+{focus_states}
+
+### Touch Targets
+
+{touch_targets}
+
+---
+
+## Implementation Notes
+
+{implementation_notes}
+
+</template>
+
+<guidelines>
+
+## Filling This Template
+
+**{aesthetic_summary}:** 2-3 sentences describing the overall visual direction. Examples:
+- "Clean and minimal with generous whitespace. Emphasis on typography over decoration. Subtle shadows for depth."
+- "Bold and energetic with high contrast. Geometric shapes and strong color accents. Modern and confident."
+
+**{brand_colors}:** Table rows with color name, hex value, and where it's used. Example:
+```
+| Primary | #2563EB | Buttons, links, key actions |
+| Primary Light | #3B82F6 | Hover states, backgrounds |
+| Accent | #8B5CF6 | Highlights, tags, badges |
+```
+
+**{type_scale}:** Table rows for each heading level and body text. Example:
+```
+| H1 | 40px | Bold | 1.2 | Page titles |
+| H2 | 32px | Bold | 1.25 | Section headers |
+| Body | 16px | Regular | 1.5 | Paragraphs |
+| Small | 14px | Regular | 1.4 | Captions, labels |
+```
+
+**{button_specs}:** Describe button variants with sizes, colors, states. Include code-ready values.
+
+**{spacing_scale}:** List spacing values. Example:
+```
+4px  - xs  - Tight spacing, inline elements
+8px  - sm  - Related items, compact layouts
+16px - md  - Standard padding, gaps
+24px - lg  - Section spacing
+32px - xl  - Major section breaks
+48px - 2xl - Page-level spacing
+```
+
+</guidelines>
+
+<examples>
+
+## Good Example
+
+```markdown
+## Aesthetic Direction
+
+Professional and trustworthy with a modern edge. Clean layouts with purposeful whitespace. Subtle depth through soft shadows. Typography-driven hierarchy—minimal decorative elements.
+
+### Visual References
+
+Inspired by Linear, Stripe, and Notion. Combines Linear's clean aesthetic with Stripe's attention to detail.
+```
+
+## Bad Example
+
+```markdown
+## Aesthetic Direction
+
+Nice looking design.
+```
+
+The bad example is too vague to guide implementation decisions.
+
+</examples>

package/get-shit-done/templates/phase-design.md

@@ -0,0 +1,205 @@
+---
+name: phase-design-template
+description: Template for phase-specific UI design documentation
+used_by:
+  - discuss-design
+placeholders:
+  - phase_number
+  - phase_name
+  - components
+  - layouts
+  - interactions
+  - mockup_files
+---
+
+<template>
+
+# Phase {phase_number}: {phase_name} - Design
+
+**Created:** {date}
+**Design System:** @.planning/DESIGN-SYSTEM.md
+
+## Overview
+
+{design_overview}
+
+---
+
+## Components
+
+{?new_components}
+### New Components
+
+| Component | Purpose | States |
+|-----------|---------|--------|
+{new_components}
+
+{/new_components}
+
+{?modified_components}
+### Modified Components
+
+| Component | Changes | Reason |
+|-----------|---------|--------|
+{modified_components}
+
+{/modified_components}
+
+### Component Specifications
+
+{component_specs}
+
+---
+
+## Layouts
+
+### Screen/Page Layouts
+
+{layout_descriptions}
+
+### Responsive Behavior
+
+| Breakpoint | Layout Changes |
+|------------|----------------|
+{responsive_changes}
+
+---
+
+## Interactions
+
+### User Flows
+
+{user_flows}
+
+### States & Transitions
+
+{state_transitions}
+
+### Loading States
+
+{loading_states}
+
+### Error States
+
+{error_states}
+
+---
+
+## Mockups
+
+| File | Description | Status |
+|------|-------------|--------|
+{mockup_files}
+
+### Running Mockups
+
+```bash
+{mockup_run_command}
+```
+
+---
+
+## Design Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+{design_decisions}
+
+---
+
+## Implementation Notes
+
+{implementation_notes}
+
+---
+
+## Checklist
+
+- [ ] All new components specified
+- [ ] States defined for each component
+- [ ] Responsive behavior documented
+- [ ] Mockups reviewed and approved
+- [ ] Follows design system
+- [ ] Accessibility considered
+
+</template>
+
+<guidelines>
+
+## Filling This Template
+
+**{design_overview}:** 2-3 sentences summarizing what UI this phase introduces or changes.
+
+**{new_components}:** Table of components created in this phase:
+```
+| PostCard | Displays a social media post | default, loading, error, empty |
+| LikeButton | Heart animation on like | idle, hovering, liked, animating |
+```
+
+**{component_specs}:** Detailed specs for each component. Include:
+- Visual description
+- Props/parameters
+- Variants
+- All states with visual differences
+- Accessibility requirements
+
+**{layout_descriptions}:** Describe how screens are structured. Include:
+- Grid/flex layout approach
+- Content ordering
+- Key regions (header, main, sidebar, etc.)
+
+**{user_flows}:** Describe interaction sequences:
+```
+1. User sees post in feed
+2. Hovers over like button → heart outline highlights
+3. Clicks like → heart fills with animation
+4. Like count increments
+```
+
+**{mockup_files}:** List of mockup files created:
+```
+| mockups/PostCard.tsx | Post card component preview | ✓ Approved |
+| mockups/Feed.tsx | Full feed layout | ✓ Approved |
+```
+
+</guidelines>
+
+<examples>
+
+## Good Component Spec
+
+```markdown
+### PostCard
+
+**Purpose:** Displays a single post in the feed with author info, content, and engagement actions.
+
+**Structure:**
+- Header: Avatar (40px), Author name, Timestamp
+- Content: Text (max 280 chars), optional media
+- Footer: Like, Comment, Share actions with counts
+
+**Variants:**
+- `default` - Standard post display
+- `compact` - Reduced padding for dense feeds
+- `featured` - Highlighted border for promoted content
+
+**States:**
+- Loading: Skeleton with pulsing animation
+- Error: "Failed to load" with retry button
+- Empty media: Placeholder with broken image icon
+
+**Accessibility:**
+- Author name is a link with focus ring
+- Action buttons have aria-labels with counts
+- Media has alt text from post data
+```
+
+## Bad Component Spec
+
+```markdown
+### PostCard
+
+A card for posts. Has a like button.
+```
+
+</examples>

package/get-shit-done/templates/phase-models-template.json

@@ -0,0 +1,71 @@
+{
+  "description": "Per-phase model configuration for GSD Autopilot",
+  "default_model": "claude-3-5-sonnet-latest",
+  "phases": {
+    "1": {
+      "model": "claude-3-5-sonnet-latest",
+      "reasoning": "Initial setup and architecture - Sonnet is cost-effective for routine tasks"
+    },
+    "2": {
+      "model": "claude-3-5-opus-latest",
+      "reasoning": "Complex implementation requiring deep reasoning"
+    },
+    "3": {
+      "model": "claude-3-5-sonnet-latest",
+      "reasoning": "Standard development work"
+    },
+    "gaps": {
+      "model": "claude-3-5-sonnet-latest",
+      "reasoning": "Gap closure typically involves straightforward fixes"
+    },
+    "continuation": {
+      "model": "claude-3-5-sonnet-latest",
+      "reasoning": "Checkpoint continuations need context but not deep reasoning"
+    },
+    "verification": {
+      "model": "claude-3-5-sonnet-latest",
+      "reasoning": "Verification is systematic testing, not complex reasoning"
+    },
+    "milestone_complete": {
+      "model": "claude-3-5-sonnet-latest",
+      "reasoning": "Completion task is straightforward"
+    }
+  },
+  "provider_routing": {
+    "claude-3-5-sonnet-latest": {
+      "provider": "anthropic",
+      "base_url": "https://api.anthropic.com"
+    },
+    "claude-3-5-opus-latest": {
+      "provider": "anthropic",
+      "base_url": "https://api.anthropic.com"
+    },
+    "glm-4.7": {
+      "provider": "z-ai",
+      "base_url": "https://open.bigmodel.cn/api/paas/v4/",
+      "auth_header": "Authorization"
+    },
+    "gpt-4o": {
+      "provider": "openai",
+      "base_url": "https://api.openai.com/v1"
+    },
+    "deepseek-reasoner": {
+      "provider": "openrouter",
+      "model_name": "deepseek/deepseek-reasoner",
+      "base_url": "https://openrouter.ai/api/v1/chat/completions"
+    }
+  },
+  "cost_optimization": {
+    "enabled": true,
+    "auto_downgrade_on_budget": {
+      "threshold_percent": 80,
+      "fallback_model": "claude-3-5-haiku-latest"
+    },
+    "task_type_routing": {
+      "research": "claude-3-5-sonnet-latest",
+      "planning": "claude-3-5-haiku-latest",
+      "coding": "claude-3-5-sonnet-latest",
+      "verification": "claude-3-5-haiku-latest"
+    }
+  }
+}

package/get-shit-done/templates/phase-prompt.md

@@ -40,7 +40,7 @@ Output: [What artifacts will be created]
 @~/.claude/get-shit-done/workflows/execute-plan.md
 @~/.claude/get-shit-done/templates/summary.md
 [If plan contains checkpoint tasks (type="checkpoint:*"), add:]
-@~/.claude/get-shit-done/references/checkpoints.md
+@~/.claude/get-shit-done/references/checkpoint-types.md
 </execution_context>
 
 <context>
@@ -75,7 +75,7 @@ Output: [What artifacts will be created]
   <done>[Acceptance criteria]</done>
 </task>
 
-<!-- For checkpoint task examples and patterns, see @~/.claude/get-shit-done/references/checkpoints.md -->
+<!-- For checkpoint task examples and patterns, see @~/.claude/get-shit-done/references/checkpoint-types.md -->
 <!-- Key rule: Claude starts dev server BEFORE human-verify checkpoints. User only visits URLs. -->
 
 <task type="checkpoint:decision" gate="blocking">
@@ -374,7 +374,7 @@ Output: Working dashboard component.
 <execution_context>
 @~/.claude/get-shit-done/workflows/execute-plan.md
 @~/.claude/get-shit-done/templates/summary.md
-@~/.claude/get-shit-done/references/checkpoints.md
+@~/.claude/get-shit-done/references/checkpoint-types.md
 </execution_context>
 
 <context>
@@ -393,7 +393,7 @@ Output: Working dashboard component.
   <done>Dashboard renders without errors</done>
 </task>
 
-<!-- Checkpoint pattern: Claude starts server, user visits URL. See checkpoints.md for full patterns. -->
+<!-- Checkpoint pattern: Claude starts server, user visits URL. See checkpoint-types.md for full patterns. -->
 <task type="auto">
   <name>Start dev server</name>
   <action>Run `npm run dev` in background, wait for ready</action>

package/get-shit-done/templates/state.md

@@ -71,6 +71,23 @@ None yet.
 Last session: [YYYY-MM-DD HH:MM]
 Stopped at: [Description of last completed action]
 Resume file: [Path to .continue-here*.md if exists, otherwise "None"]
+
+## Autopilot
+
+- **Mode:** [idle | running | paused | completed | failed]
+- **Started:** [timestamp or "—"]
+- **Current Phase:** [phase number or "—"]
+- **Phases Remaining:** [list or "none"]
+- **Checkpoints Pending:** [count or "none"]
+- **Last Error:** [error description or "none"]
+- **Updated:** [timestamp]
+
+## Cost Tracking
+
+| Phase | Tokens | Est. Cost |
+|-------|--------|-----------|
+| — | — | — |
+| **Total** | 0 | $0.00 |
 ```
 
 <purpose>
@@ -161,6 +178,26 @@ Enables instant resumption:
 - What was last completed
 - Is there a .continue-here file to resume from
 
+### Autopilot
+Tracks autonomous execution state:
+- **Mode:** idle (not running), running (actively executing), paused (budget/checkpoint), completed, failed
+- **Started:** When autopilot began
+- **Current Phase:** Which phase is being executed
+- **Phases Remaining:** Phases yet to execute
+- **Checkpoints Pending:** Count of checkpoints awaiting human approval
+- **Last Error:** Most recent error if failed/paused
+- **Updated:** Last state change timestamp
+
+Updated by autopilot script during execution.
+
+### Cost Tracking
+Tracks token usage and estimated cost:
+- Per-phase breakdown
+- Running total
+- Used for budget enforcement
+
+Updated after each phase completes.
+
 </sections>
 
 <size_constraint>