claude-os/templates/project-files/agent-os-section.md at main

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

2.9 KiB

Raw Permalink Blame History

Agent-OS: Spec-Driven Development (Optional)

Agent-OS provides 8 specialized agents for structured feature development:

Specification Workflow

/new-spec - Initialize new feature specification
- Creates spec directory structure
- Sets up planning workflow
- Example: /new-spec user-authentication
/create-spec - Full specification creation workflow
- Gathers requirements through targeted questions (1-3 at a time)
- Collects visual assets
- Identifies reusable code
- Creates detailed specification and task breakdown
- Example: /create-spec
/plan-product - Product planning and documentation
- Creates mission.md, roadmap.md, tech-stack.md
- Defines product vision and technical direction
- Example: /plan-product
/implement-spec - Implement a specification
- Follows tasks.md from spec
- Implements features step-by-step
- Verifies implementation against spec
- Example: /implement-spec user-authentication

The 8 Agent-OS Agents

Available in .claude/agents/agent-os/:

spec-initializer - Initialize new spec directories
spec-shaper - Gather requirements through iterative questions
spec-writer - Create detailed technical specifications
tasks-list-creator - Break specs into actionable tasks
implementer - Implement features following tasks
implementation-verifier - Verify implementation completeness
spec-verifier - Verify specs and tasks consistency
product-planner - Create product documentation

Agent-OS 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
├── specs/              # Feature specifications
│   └── YYYY-MM-DD-feature-name/
│       ├── planning/
│       │   ├── requirements.md
│       │   └── visuals/
│       ├── spec.md
│       └── tasks.md
└── standards/          # Coding standards (as skills)

How Agent-OS Works with Claude OS

Agent-OS agents integrate deeply with Claude OS:

Search memories before creating specs (avoid reinventing the wheel)
Save decisions to project_memories during specification
Reference patterns from previous work
Build knowledge over time

Best Practices

Always start with /new-spec for new features
Provide visual mockups when available (speeds up requirements)
Answer questions thoughtfully (agents ask 1-3 at a time now!)
Reference existing code (agents will search for patterns)
Let agents guide you through the structured workflow

See agent-os/README.md for detailed Agent-OS documentation.

2.9 KiB Raw Permalink Blame History