chama

Chama

SDLC pipeline orchestrator for Claude Code — Bootstrap -> Idea -> Spec -> Code -> Review -> Merge.

Chama is a Claude Code plugin that brings a full development lifecycle workflow to any project. Configure once with .chama.yml and CLAUDE.md, then use slash commands to drive your development.

The name "chama" combines fire with the act of "calling/invoking" — perfect for a CLI of commands.

Quick Start

1. Install

# Add the marketplace
/plugin marketplace add rafaelportugal/chama

# Install the plugin
/plugin install chama@chama

2. Bootstrap or onboard your project

# Option A: Create a new project from scratch (local-first)
/chama:new-project

# Option B: Onboard an existing project (GitHub setup)
/chama:init

3. Start building

/chama:ideas        # Brainstorm and create structured ideas
/chama:architect N  # Transform idea #N into Spec + phases
/chama:code         # Execute next task from backlog
/chama:review-loop  # Process PR review comments

Commands

Command	Description
/chama:new-project	Guided bootstrap — idea -> synthesis -> local foundation (.chama.yml, CLAUDE.md, README.md, LICENSE, docs/)
/chama:adopt	Adopt existing repo — analyze stack, generate diagnosis and transformation plan
/chama:init	Project onboarding — creates .chama.yml, GitHub labels, project board
/chama:ideas	Ideas studio — brainstorm with Product Lead + Designer personas
/chama:architect	Idea -> Spec + phases (all as GitHub Issues)
/chama:code	Execute next Todo task with quality gates
/chama:review-loop	Handle PR comments in loop, scoped by Spec
/chama:gate-check	Run Critical Gate analysis on working tree or specific commit

Command Flow

/chama:new-project -> guided bootstrap: idea -> synthesis -> local foundation
       | (optional)
/chama:init        -> onboard project (GitHub labels, board, project number)
       |
/chama:ideas       -> brainstorm -> GitHub Issue (label: idea)
       |
/chama:architect   -> idea Issue -> Spec Issue + phase Issues
       |
/chama:code        -> phase Issue (Todo) -> implement -> PR
       |
/chama:review-loop -> PR comments -> fix/respond -> merge

Note: /chama:new-project is local-first — it generates project foundation on the local filesystem without requiring GitHub. It composes with /chama:init (which handles GitHub setup) but does not depend on it.

Configuration

.chama.yml

Per-project configuration file:

project:
  name: "MyProject"
  description: "Brief description"
  repo: "owner/repo-name"
  language: "pt-BR"              # or "en"

github:
  owner: "owner"
  project_number: 1
  default_branch: "main"
  board_statuses:                    # optional — customize to match your board
    todo: "Todo"
    in_progress: "In Progress"
    in_review: "In Review"
    done: "Done"

tech_stack:
  summary: "Go backend + Next.js frontend"
  components:
    - name: "backend"
      path: "backend/"
      quality_gates:
        - "cd backend && make test"
        - "cd backend && make lint"
    - name: "frontend"
      path: "frontend/"
      quality_gates:
        - "cd frontend && npm run typecheck"
        - "cd frontend && npm run lint"

artifacts:
  progress_dir: ".chama/progress"
  reviews_dir: ".chama/reviews"

personas:
  - name: "Admin"
    description: "System administrator"

# knowledge_paths:                  # optional — feeds domain docs into /chama:architect
#   - "docs/"

critical_gates:
  enabled: true
  fail_mode: open
  severity_block:
    - CRITICAL
    - HIGH
  scan_points:
    - pre_commit
    - pre_merge

versioning:
  enabled: true
  strategy: "spec-lifecycle"
  files:
    - path: ".claude-plugin/plugin.json"
      jq_filter: ".version"

business_segment: "SaaS"

Environment variable overrides

CHAMA_REPO="owner/repo"
CHAMA_OWNER="owner"
CHAMA_PROJECT_NUMBER="1"
CHAMA_DEFAULT_BRANCH="main"

Features

Knowledge Paths

Add knowledge_paths to .chama.yml to feed domain docs (.md, .yml, .yaml, .txt) into the architect. Progressive limits apply:

• 10 files / 100KB: read all, no alerts
• 11-15 files / 101-200KB: read all + warning
• >15 files / >200KB: skip with error

Custom Spec Template

Override the default spec template by placing your own at .chama/templates/spec.md. The architect will use it instead of the built-in default.

Critical Gate

Pre-commit and pre-merge safety checks for destructive operations. Scans diffs for database drops, secret exposure, infra changes, and ~40 built-in rules across 6 domains. Run standalone with /chama:gate-check.

Versioning

Manual bump with LLM-generated changelog:

make bump-version

Shows commits since last bump, generates a categorized changelog via claude --print, asks for bump type (patch/minor/major), and commits.

Permissions Setup