Skip to content

onblueroses/strata

Repository files navigation

strata

Strata is a skeleton for coding agents. Skills, hooks, commands, references; one CLAUDE.md as the spine. Harness is the composition primitive: cross-model adversarial generate-evaluate against frozen artifacts. The agent dispatches the thinking; you keep the synthesis.

Layout

bin/        symbolic model lanes (strong | fast | grader | breadth) + dispatch + init
skills/     procedural knowledge the agent loads on demand (spec, recon, harness, ...)
commands/   user-invoked slash commands (verify, review, end, best-of-n, commit, pickup)
agents/     subagent definitions (planner, quick-research, code-reviewer, knowledge-lookup, pattern-extractor)
hooks/      event-driven scripts (Stop, PreToolUse, PostToolUse, SessionStart, ...)
reference/  long-form docs the agent reads on the right prompt (router + INDEX)
config/     model-map.toml (symbolic-lane bindings) + private-tokens.example.txt
workspace/  PARA-flavored knowledge-base tree (areas | projects | resources | daily | inbox | archives)

CLAUDE.md at the repo root is the operating doctrine the agent reads first.

Install

git clone https://github.com/onblueroses/strata.git ~/.strata
~/.strata/bin/strata-init

strata-init writes a shell-rc block, populates the workspace tree, and prompts you to fill config/model-map.toml with the strongest models you currently have access to. See SETUP.md for the walkthrough.

Operating model

  • Delegate. The orchestrator session dispatches code, reviews, and probes to lane wrappers (bin/strong, bin/fast, bin/grader, bin/breadth). Your context stays free for synthesis.
  • Gate completion. The Stop hook enforces that /verify passes before the session can end on any tier above Skip. Run /verify after editing files; the hook blocks session close otherwise. Knowledge-base markdown auto-passes; code edits run inline or Codex checks.
  • Persist to files. Specs at workspace/state/specs/ survive context compaction. Sessions resume by reading >> Current Step.
  • Parallel-safe. Every state file is session-id-keyed ($CLAUDE_SESSION_ID); concurrent sessions never clobber each other.
  • Harness for hard problems. /harness generates N candidates, grades against a frozen rubric, iterates until aggregate PASS. /best-of-n runs the same shape for design-space questions.

Skeleton, not config bundle

Strata ships the substrate, not a curated set of domain packs. Project-specific skills, vendor automations, and personal references live in separate repos. Adapt the kernel; bring your own packs.

License

MIT

Attributions

A subset of the writing/voice/hermeneutics skills under skills/ is ported from Wondermonger-daydreaming/claude-skills-library (MIT).

About

Agent harness for AI coding tools. 52 skills, 16 hooks, context system (doc routing, memory hints, compaction recovery), one bootstrap prompt.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors