Assembly

Assembly is a minimal, deterministic context compiler that will produce a stable pack/ directory for agent runners. The spec targets a simple, reproducible selection pipeline and a predictable pack interface.

Note: This project is ~80% AI-generated using Codex CLI, a Swiss Army knife, duct tape, and some chewing gum.

Completion status (as of 2026-01-29)

• Phase 1 complete
  • Spec and interface docs are complete (ASSEMBLY_SPEC.md, INTERFACE.md).
  • Example pack is checked in (assembly/examples/pack-minimal/).
• Phase 2 complete
  • Deterministic pack production tasks are tracked in prd.json.

Usage

Build a pack from a repo and task input:

python -m assembly build --repo . --task "@task.txt" --task-id ASM-011

Common options:

• --task accepts inline text or @<file> references.
• --out defaults to pack/ and contains manifest.json, index.json, context.md, policy.md, lint.json.
• --max-tokens defaults to 6000.
• --include/--exclude can be repeated to override the default globs.

If you prefer the wrapper script:

./bin/assembly build --repo . --task "Summarize repo structure." --task-id ASM-012

How to use this repo

• Read the spec: ASSEMBLY_SPEC.md.
• Use the pack contract: INTERFACE.md.
• Inspect the example pack: assembly/examples/pack-minimal/.

Development

The Ralph loop and task agent have moved to https://github.com/signalreason/lever. This repo focuses on the pack spec and compiler; see Lever for task-running tools.