How coodiepee/grspec works
grspec is a CLI framework that structures AI-assisted development around proposals, requirements, designs, task plans, implementation, and archival spec synchronization. The main user workflow starts with project initialization and tool-specific artifact generation, then an AI assistant uses generated workflows to create and apply changes; CLI commands support validation, status, and archive operations. Additional product branches provide tool customization, wiki knowledge, UI/UX guidance, and a terminal dashboard. Several command implementations are not sampled, so links between registered CLI commands and internal subsystems are shown only where the README documents the behavior.
Main entry points: cli/index.ts grspec CLI · workflow/index.ts Workflow Commands · init.ts Project Init · archive.ts Archive Changes
Components 23
CLI Entry
- grspec CLI
src/cli/index.ts - Project Init
src/commands/init.ts
Spec Workflow
- Workflow Commands
src/commands/workflow/index.ts - Change Artifacts
src/core/templates/workflows/new-change.ts - Markdown Parser
src/core/parsers/markdown-parser.ts - Change Delta Parser
src/core/parsers/change-parser.ts - Artifact Graph
src/core/artifact-graph/index.ts - Apply Specs
src/core/specs-apply.ts - Archive Changes
src/core/archive.ts - Spec Validation
src/core/validation/validator.ts
Tool Delivery
- Command Generation
src/core/command-generation/index.ts - Rule Generation
src/core/rule-generation/index.ts - Workflow Skills
src/core/templates/workflows
Knowledge and Design
- Wiki Knowledge
src/core/wiki.ts - Design Search
src/core/ui/search.ts - UX Review
src/core/ui/review.ts
Project Management
- Terminal Dashboard
src/core/view.ts - Project Config
src/core/project-config.ts - Project Workspace
- Usage Telemetry
src/telemetry/index.ts
Other components
- Developer
- AI Assistant
- Analytics Service
Connections 22
- Developer → grspec CLI: runs commands
- grspec CLI → Project Init: dispatches
- grspec CLI → Workflow Commands: dispatches
- grspec CLI → Usage Telemetry: tracks command
- Usage Telemetry → Analytics Service: sends events
- Project Init → Command Generation: generates commands
- Project Init → Rule Generation: generates rules
- Project Init → Workflow Skills: installs skills
- Project Init → Project Config: configures project
- Workflow Commands → Change Artifacts: creates workflow
- AI Assistant → Change Artifacts: follows instructions
- Workflow Commands → Artifact Graph: resolves artifacts
- Workflow Commands → Spec Validation: validates changes
- Workflow Commands → Apply Specs: applies specs
- Workflow Commands → Archive Changes: archives changes
- Change Delta Parser → Markdown Parser: extends parsing
- AI Assistant → Project Workspace: implements changes
- Archive Changes → Project Workspace: syncs archived specs
- grspec CLI → Terminal Dashboard: opens dashboard
- grspec CLI → Wiki Knowledge: dispatches wiki
- grspec CLI → Design Search: dispatches UI search
- grspec CLI → UX Review: dispatches UX review