Fraim Spec+

[Vision and purpose - fill in]

What is this?

[Describe what Fraim Spec+ does]

Why does it exist?

[Problem being solved]

Goals

• Goal 1
• Goal 2
• Goal 3

---

Project Structure

fraim-spec/
├── src/
│   ├── agents/           # Runtime agents (Claude Agent SDK)
│   │   ├── __init__.py   # Agent registry
│   │   └── _template.py  # Copy to create new agents
│   └── tools/            # Shared tools across agents
│
├── tests/                # TDD tests
│
├── .claude/              # Claude Code configuration
│   ├── skills/           # Development workflows
│   │   ├── add-feature.md
│   │   └── add-agent.md
│   └── hooks/            # Automation hooks
│       └── hooks.json
│
├── docs/                 # Documentation
├── CLAUDE.md            # Claude Code instructions
└── pyproject.toml       # Dependencies

Agents

Agent	Purpose	Status
(none yet)	-	-

Quick Start

# Setup
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

# Development
make test    # Run tests
make lint    # Lint + type check
make all     # Full CI
make push    # Test then push

# Create a new agent
cp src/agents/_template.py src/agents/my_agent.py
# Edit and register in src/agents/__init__.py

Development with Claude Code

This project uses Claude Code skills for deterministic development:

• /add-feature - Guided feature implementation with TDD
• /add-agent - Create new runtime agents

See CLAUDE.md for full development instructions.

---

License

[Choose license]