History

Bob Roberts f9a7a2aa23 Add production deployment guide and quick reference documentation Add comprehensive documentation for Claude OS deployment and daily usage. Documentation Added: - docs/PRODUCTION_DEPLOYMENT.md: Complete production deployment guide - Server architecture and resource allocation - SQLite deployment (simpler than PostgreSQL for read-heavy workloads) - Step-by-step deployment instructions - Integration with Rails applications - Service management, backups, monitoring - Troubleshooting and performance optimization - Security considerations - docs/QUICK_REFERENCE.md: Developer quick reference - All slash commands with examples - Skills and trigger phrases - Agent-OS commands (if installed) - Common workflows - Production server commands - API endpoints for integration - Troubleshooting guide - Printable cheat sheet Templates Added: - templates/agents/: 8 Agent-OS agent templates - spec-initializer, spec-shaper, spec-writer - tasks-list-creator, implementer - implementation-verifier, spec-verifier - product-planner - templates/project-files/agent-os/: Agent-OS project structure - config.yml.template - README.md with setup instructions - .gitignore for state files Updates: - templates/commands/claude-os-init.md: Enhanced project initialization - templates/project-files/CLAUDE.md.template: Improved project context Benefits: - Easy onboarding for new team members - Complete deployment automation - Production-ready configuration - Comprehensive troubleshooting - All commands in one place 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>		2025-10-30 20:25:10 -05:00
..
.gitignore	Add production deployment guide and quick reference documentation	2025-10-30 20:25:10 -05:00
config.yml.template	Add production deployment guide and quick reference documentation	2025-10-30 20:25:10 -05:00
README.md	Add production deployment guide and quick reference documentation	2025-10-30 20:25:10 -05:00

README.md

Agent-OS for {{PROJECT_NAME}}

Overview

Agent-OS is a spec-driven development system that integrates with Claude OS to provide structured workflows for planning and implementing features.

Directory Structure

agent-os/
├── config.yml          # Agent-OS configuration
├── product/            # Product documentation
│   ├── mission.md      # Product mission and goals
│   ├── roadmap.md      # Feature roadmap
│   └── tech-stack.md   # Technology stack documentation
├── specs/              # Feature specifications
│   └── YYYY-MM-DD-feature-name/
│       ├── planning/
│       ├── spec.md
│       └── tasks.md
└── standards/          # Coding standards
    ├── backend/
    ├── frontend/
    ├── global/
    └── testing/

How It Works

Agent-OS provides 8 specialized agents accessible via slash commands:

/new-spec - Initialize a new feature specification
/create-spec - Create comprehensive specification with requirements gathering
/plan-product - Plan product mission, roadmap, and tech stack

The agents work together to:

Gather requirements through targeted questions
Create detailed specifications
Generate task breakdowns
Implement features
Verify implementations

Integration with Claude OS

Agent-OS agents use Claude OS knowledge bases to:

Search for similar patterns and solutions
Save decisions and learnings
Build on previous work
Maintain context across sessions

Getting Started

Create your first spec:
```
/new-spec
```
The agent will guide you through:
- Requirements gathering
- Visual asset collection
- Existing code identification
- Specification creation
- Task breakdown
- Implementation

Your spec will be saved to:

agent-os/specs/YYYY-MM-DD-your-feature-name/

Best Practices

Start with /new-spec for all new features
Provide visual mockups when available (place in specs/[spec-name]/planning/visuals/)
Reference existing code to promote reusability
Let the agents guide you through the process

Commands Available

/new-spec - Initialize new specification
/create-spec - Full spec creation workflow
/plan-product - Product planning
/implement-spec - Implement a specification

Learn More

See .claude/agents/agent-os/ for agent definitions and workflows.