Home

harnessed documentation

harnessed is a host-native Python CLI that assembles and launches AI-agent container stacks from declarative recipe/agent/service/stack YAML. This wiki holds the project's guides, design docs, and planning notes — it's mirrored into the main repo as the docs/ git submodule.

Start here

• ARCHITECTURE — repo layout, the agent/recipe/service/stack/catalog vocabulary, the host-native build/launch model, and the capability-test oracle. Read this first.
• CONTRIBUTING — dev setup and how to add a recipe / agent / service / stack.
• AGENTS.md — operational notes for AI assistants working on this repo.
• harnessed-design.md — the deeper rationale behind the architecture (the why).

Guides (how-to)

• Recipe authoring
• Service authoring
• Stacks
• Secrets (varlock + 1Password)
• Container filesystem layout
• Troubleshooting

Codebase map

Generated by /map-codebase — the where the code lives, how it's written, what's wired to what reference. Regenerate periodically rather than hand-editing.

• ARCHITECTURE · STRUCTURE · CONVENTIONS · INTEGRATIONS · STACK · TESTING · CONCERNS

Planning & roadmap

• ROADMAP — the living status/decision-history doc: what shipped, why work was sequenced this way, open decisions. Ranked open work itself now lives in bd (this project's issue tracker) — see bd ready / bd list --status=open, not a markdown list here.
• done/ — closed-out planning docs kept for audit trail.

Research & prompts

• research/ — investigation notes (home-folder requirements per harness, etc.)
• prompts/ — reusable prompt templates (e.g. recipe-authoring-prompt.md)
• recipe-build-findings.md — accumulated findings from building/debugging recipes

Editing this wiki

This content is mirrored from the harnessed repo's docs/ submodule. Edit here (via the wiki UI or by cloning git@github.com:drmikecrowe/harnessed.wiki.git), then bump the submodule pointer in the main repo to pick up changes there.