SheWhoReignsSupreme/claude-os
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
claude-os/templates
History
Bob Roberts ddf3bac39b CRITICAL FIXES: Consolidate templates + API improvements 
This commit fixes several critical issues found during comprehensive review:

## CRITICAL FIX: Template Consolidation ⚠️
- Moved 6 commands from ~/.claude/commands/ to templates/commands/
- Moved 3 skills from ~/.claude/skills/ to templates/skills/
- Team sharing was BROKEN without this (symlinks pointed to empty dirs)
- Updated README with prominent consolidation step warning
- Commands: list, remember, save, search, session, triggers
- Skills: initialize-project, remember-this, memory

## HIGH PRIORITY FIXES:
- ✅ Completed selective semantic indexing (removed TODO at line 878)
- ✅ Fixed PostgreSQL references in health check (system uses SQLite)
- ✅ Created comprehensive API documentation (docs/API_REFERENCE.md)
- ✅ Added Depends import to fix authentication endpoints

## DOCUMENTATION:
- Added complete API_REFERENCE.md (60+ endpoints documented)
- Created HYBRID_INDEXING_INTEGRATION.md (5 KB architecture)
- Updated README with API docs link + consolidation warning
- Documented all hybrid indexing endpoints with examples

## IMPROVEMENTS:
- Selective semantic indexing now actually ingests files (was placeholder)
- Health check now correctly queries SQLite instead of PostgreSQL
- All authentication endpoints now functional
- Structural indexing stores as pure JSON (no embeddings)

Impact: Team sharing now works, all features documented, critical bugs fixed.
Tested: Pistn indexing (3,117 files in 3 seconds) ✅

🚀 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-31 14:23:43 -05:00
..
agents Add production deployment guide and quick reference documentation 2025-10-30 20:25:10 -05:00
commands CRITICAL FIXES: Consolidate templates + API improvements 2025-10-31 14:23:43 -05:00
project-files Add production deployment guide and quick reference documentation 2025-10-30 20:25:10 -05:00
skills CRITICAL FIXES: Consolidate templates + API improvements 2025-10-31 14:23:43 -05:00
README.md Add packaging and sharing system 2025-10-30 18:53:58 -05:00

README.md

Claude OS Templates

This directory contains all template files used when initializing a new project with Claude OS.

Directory Structure

templates/
├── commands/           # Slash command templates (symlinked to projects)
├── skills/             # Skill templates (symlinked to projects)
├── agents/             # Agent templates (project-specific)
├── project-files/      # Files created during project init
│   ├── CLAUDE.md.template
│   ├── .claude-os/
│   │   ├── config.json.template
│   │   ├── hooks.json.template
│   │   └── .gitignore
│   └── README.md
└── README.md          # This file

Template Variables

Templates use {{VARIABLE}} syntax for placeholders that get replaced during project initialization:

Common Variables

  • {{PROJECT_NAME}} - Project name (e.g., "my-app")
  • {{PROJECT_DESCRIPTION}} - Brief project description
  • {{TECH_STACK}} - Technology stack (e.g., "Ruby on Rails, MySQL")
  • {{DATABASE}} - Database system (e.g., "PostgreSQL", "MySQL")
  • {{DEV_ENVIRONMENT}} - Dev environment (e.g., "Docker", "Local")
  • {{CLAUDE_OS_URL}} - Claude OS server URL (default: http://localhost:8051)
  • {{DOCS_PATHS}} - JSON array of documentation paths
  • {{CREATED_AT}} - ISO timestamp of creation
  • {{PROJECT_SPECIFIC_CONTENT}} - Custom project content
  • {{DEVELOPMENT_GUIDELINES}} - Project-specific guidelines
  • {{COMMON_TASKS}} - Common development tasks
  • {{BUSINESS_RULES}} - Key business rules

How Templates Are Used

When running /claude-os-init:

  1. Commands & Skills - Symlinked from templates/commands/ and templates/skills/ to project's .claude/ directory
  2. Project Files - Copied from templates/project-files/ with variables replaced
  3. Knowledge Bases - Created via API with project-specific names
  4. MCP Configuration - Updated in ~/.claude/mcp-servers/ with new project

Adding New Templates

New Command Template

  1. Create file in templates/commands/my-command.md
  2. Add command logic
  3. Will be automatically available after /claude-os-init

New Skill Template

  1. Create directory in templates/skills/my-skill/
  2. Add SKILL.md and any scripts
  3. Will be automatically available after /claude-os-init

Updating CLAUDE.md Template

Edit templates/project-files/CLAUDE.md.template to add:

  • New sections
  • Updated workflow instructions
  • Additional context

Changes will apply to NEW projects only. Existing projects keep their CLAUDE.md unchanged.

Consolidation Scripts

See /Users/iamanmp/Projects/claude-os/cli/ for scripts to:

  • Move commands from ~/.claude/commands/ to templates/commands/
  • Move skills from ~/.claude/skills/ to templates/skills/
  • Update existing projects to use templates

For Coworkers

When you clone Claude OS and run ./install.sh, these templates are:

  1. Registered with your Claude CLI
  2. Available for new project initialization
  3. Ready to use with /claude-os-init

Then cd to any project and run /claude-os-init to connect it to Claude OS!