How ursisterbtw/ccprompts works
Project Type and Purpose
• This is a CLI-centric command/agent framework (“ccprompts”) for Claude Code, providing ~70 reusable commands across development phases, plus agent templates, safety-wrapped execution, validation, workflows, and CI/CD integration.
• It’s not a monolithic web app but a “toolchain” library: commands live under .claude/, agents under agents/, execution tooling in scripts/ and src/ (Dagger safety container), plus docs, tests, and GitHub workflows.
a. CLI Interface
• src/index.ts – entry point
• package.json scripts (npm run validate, npm run test, etc.)
b. Command Registry
• .claude/commands/*/*.md – individual command definitions organized by phase
• .claude/settings.json and config.json – ecosystem configuration
• templates/SUB_AGENT_TEMPLATE.md – skeleton for sub-agent generation
c. Agent System
• .claude/agents/*.md – built-in agent specs
• Workflow orchestrator (YAML under .claude/workflows/) to chain commands
d. Safety & Validation Engine
• scripts/ – shell wrappers (safe-run.sh/quick-safe.sh), JS validators (validators/*.js), safety-patterns.js
• src/ – Dagger container definitions for sandboxed command execution
e. Testing Suite
• tests/ – Jest tests for command structure, integration, safety, performance, validators
• jest.config.js, setup/teardown scripts
f. Documentation & Examples
• docs/ – API reference, developer guide, usage, workflow guides, safety documentation, assets
g. CI/CD & Automation
• .github/workflows/ – primary pipelines (validate prompts, code review, security scan)
• .github/actions/ – reusable actions (setup-node, security-scan, artifact-handling)
h. External Services
• GitHub Actions – for CI, tests, linting, markdown-link-check
• Dagger.io – container runtime for safe execution
• User CLI → (invokes) → src/index.ts → (loads) → Command Registry
• Command Registry → (feeds) → Safety & Validation Engine → (spawns) → Dagger Container
• Dagger Container → (executes) → Host filesystem changes or external tools → returns results
• Agent System → (provides templates) → Command Registry & Workflows → orchestrated by index.ts
• Tests Suite → (validates) → Command definitions, Validation Engine, Agent configs
• CI/CD Pipelines → (trigger) → Tests Suite & Validation Engine → (report) → GitHub UI
Architectural Patterns & Design Principles
• Plugin architecture: commands are “plugins” described in Markdown, loaded at runtime.
• Sandbox pattern: Dagger containers isolate risky operations.
• Convention over configuration: phases (00–11) define structure.
• Template method: agent-template-wizard uses a 7-step methodology to scaffold new agents.
• Declarative workflows: YAML files in .claude/workflows/ define multi-step processes.
Technologies & Frameworks
• Node.js & TypeScript (src/index.ts, npm scripts)
• Dagger.io for containerized safety
• Jest for testing
• GitHub Actions for CI/CD
• YAML for workflows
• Shell scripts for quick wrapper utilities
• Markdown for command/agent definitions