rungs wiki — documentation

Wiki
Documentation
Corpus
docs/ · rendered from plain markdown
Documents
179
Built
2026-09-13 UTC
Overview
documentsourcestatus
rungsREADME.md—
Working rules
documentsourcestatus
CLAUDE.mdCLAUDE.md—
Research
documentsourcestatus
Researchdocs/research/README.md—
Follow-on public-agent researchdocs/research/follow-on/README.md—
Evaluation/optimization track templatedocs/research/follow-on/EVALUATION-TEMPLATE.md—
DSPy — metric-driven agent program optimizationdocs/research/follow-on/evaluations/dspy.md—
Inspect AI — reproducible evaluation and sandboxed evidencedocs/research/follow-on/evaluations/inspect-ai.md—
Durable/local product track templatedocs/research/follow-on/PRODUCT-TEMPLATE.md—
Aider — git-first coding, repository context, and validationdocs/research/follow-on/products/aider.md—
Google ADK — runner events, resumable confirmation, schema migration, and language paritydocs/research/follow-on/products/google-adk.md—
goose — local state machine, MCP extensions, ACP providers, and session isolationdocs/research/follow-on/products/goose.md—
Letta Code — durable memory, identity, and continual learningdocs/research/follow-on/products/letta-code.md—
Interoperability protocol track templatedocs/research/follow-on/PROTOCOL-TEMPLATE.md—
A2A — opaque-agent discovery, task ownership, and artifact deliverydocs/research/follow-on/protocols/a2a.md—
MCP — the negotiated tool and context boundarydocs/research/follow-on/protocols/mcp.md—
Follow-on extraction — shared comparison spinedocs/research/follow-on/SHARED-SPINE.md—
Follow-on research synthesis — owners, evidence, and non-equivalent boundariesdocs/research/follow-on/synthesis.md—
Public agent frameworksdocs/research/frameworks/README.md—
LangGraphdocs/research/frameworks/langgraph.md—
Microsoft Agent Frameworkdocs/research/frameworks/microsoft-agent-framework.md—
OpenAI Agents SDKdocs/research/frameworks/openai-agents-sdk.md—
OpenHandsdocs/research/frameworks/openhands.md—
Pydantic AIdocs/research/frameworks/pydantic-ai.md—
SWE-agentdocs/research/frameworks/swe-agent.md—
Public agent-framework synthesisdocs/research/frameworks/synthesis.md—
${${Framework name}}docs/research/frameworks/TEMPLATE.md—
Harness landscape — format snapshotdocs/research/harness-landscape.md—
Pattern catalogdocs/research/pattern-catalog.md—
Extraction — axiom-meshdocs/research/repos/axiom-mesh.md—
Extraction — hexguarddocs/research/repos/hexguard.md—
Extraction — hexguard-templatesdocs/research/repos/hexguard-templates.md—
Extraction — rift-forgedocs/research/repos/rift-forge.md—
Cross-repo synthesisdocs/research/synthesis.md—
Design
documentsourcestatus
Designdocs/design/README.md—
Cross-repo evidence: the argument, at its strongest, and the answerdocs/design/cross-repo-evidence-2026-08-16.md—
Detection verificationdocs/design/detection-verification.md—
Existing promises — evidence matrix, 2026-09-06docs/design/existing-promises-evidence-2026-09-06.md—
Existing promises — remediation promptdocs/design/existing-promises-remediation-prompt.md—
doctor --explain false-positive census, 2026-08-16docs/design/explain-census-2026-08-16.md—
External review, 2026-08-16 — record and adjudicationdocs/design/external-review-2026-08-16.md—
External review #2, 2026-08-16 — record and adjudicationdocs/design/external-review-2026-08-16b.md—
Imperative detection — corpus, before the matcherdocs/design/imperative-corpus-2026-08-17.md—
Imperative detection — the hand-classified oracledocs/design/imperative-oracle-2026-09-06.md—
Local interface contractdocs/design/local-interface.md—
Local interface verification — 2026-09-13docs/design/local-interface-verification-2026-09-13.md—
Local operator interface assessmentdocs/design/local-operator-interface-2026-09-13.md—
Module catalogdocs/design/module-catalog.md—
Module parametersdocs/design/parameters.md—
Product briefdocs/design/product-brief.md—
Release-readiness assessmentdocs/design/release-readiness.md—
Release runbook — releasing rungs itselfdocs/design/release-runbook.md—
Rift Forge capability matrixdocs/design/rift-forge-capability-matrix.md—
Tool evaluation — 2026-09-05docs/design/tool-evaluation-2026-09-05.md—
Prompt — design system for the rungs web surfacesdocs/design/web-design-system-prompt.md—
WI-032 claim inventorydocs/design/WI-032-claim-inventory.md—
Decisions
documentsourcestatus
Decisionsdocs/decisions/README.md—
Multi-harness rendering: render only what is fragmenteddocs/decisions/ADR-0001-multi-harness-rendering.mdaccepted
Implementation stack, and the runtime footprint of a scaffolded repodocs/decisions/ADR-0002-stack-and-runtime-footprint.mdaccepted
Module definition format: a directory that looks like what it emitsdocs/decisions/ADR-0003-module-definition-format.mdaccepted
Adoption detection: map what exists, never migrate itdocs/decisions/ADR-0004-adoption-detection.mdaccepted
Self-instrumentation: the runner records what it observes, and nothing elsedocs/decisions/ADR-0005-self-instrumentation.mdaccepted
The name: `rungs`, and why a name here is an identifier rather than a branddocs/decisions/ADR-0006-the-name.mdaccepted
Detector applicability is declared per gate, and has no defaultdocs/decisions/ADR-0007-detector-applicability.mdaccepted
A gate tier is an ordered level, and an unknown tier is refuseddocs/decisions/ADR-0008-gate-tiers-are-levels.mdaccepted
rungs drives git for the concurrency loop, and only where the loop is the productdocs/decisions/ADR-0009-rungs-drives-git.mdaccepted
A hook is dispatched through the consumer's pinned launcher to a central enginedocs/decisions/ADR-0010-hooks-dispatch-through-the-launcher.mdaccepted
An instruction detector reports what it read and asserts nothing about enforcementdocs/decisions/ADR-0011-instruction-detectors-assert-no-enforcement.mdaccepted
Short imperative statement of the decisiondocs/decisions/TEMPLATE.mdproposed
Backlog
documentsourcestatus
Delivery methodology & backlogdocs/backlog/README.md—
Working on a work itemdocs/backlog/AGENTS.md—
Archivedocs/backlog/archive/README.md—
Infer project_name from the repo directory, as its own default already promisesdocs/backlog/archive/WI-001-infer-project-name.mddone
Accept --set k=v, and refuse an unparsed positional instead of silently retargetingdocs/backlog/archive/WI-002-set-flag-parsing.mddone
Stop .ai/rungs.toml instructing a fix that rungs render cannot performdocs/backlog/archive/WI-003-render-reports-what-it-cannot-reemit.mddone
Reconcile rungs --help with the README's command tabledocs/backlog/archive/WI-004-help-completeness.mddone
End doctor with a recommended next commanddocs/backlog/archive/WI-005-doctor-next-step.mddone
A parameter reference, generated from the manifestsdocs/backlog/archive/WI-006-parameter-reference.mddone
A first-hour guide — the surface between install and the first work itemdocs/backlog/archive/WI-007-first-hour-guide.mddone
Stop a template token switching off link checking for a whole filedocs/backlog/archive/WI-008-link-gate-checks-every-file.mddone
Extract a second research corpus — six public agent frameworksdocs/backlog/archive/WI-009-public-agent-framework-corpus.mddone
A fixed template and method for the public-framework corpusdocs/backlog/archive/WI-010-framework-extraction-template.mddone
Extract SWE-agent — the minimal coding-agent loopdocs/backlog/archive/WI-011-extract-swe-agent.mddone
Extract LangGraph — state, checkpoints, and long-running workflowsdocs/backlog/archive/WI-012-extract-langgraph.mddone
Extract the OpenAI Agents SDK — a deliberately small primitive surfacedocs/backlog/archive/WI-013-extract-openai-agents-sdk.mddone
Extract Pydantic AI — typing, injection, and testable agentsdocs/backlog/archive/WI-014-extract-pydantic-ai.mddone
Extract the Microsoft Agent Framework — enterprise .NET and multi-agent workflowsdocs/backlog/archive/WI-015-extract-microsoft-agent-framework.mddone
Extract OpenHands — a shipped autonomous agent, sandboxing and scaledocs/backlog/archive/WI-016-extract-openhands.mddone
Synthesize the framework corpus and reconcile it with the pattern cataloguedocs/backlog/archive/WI-017-framework-synthesis.mddone
Extend public-agent research across memory, evaluation, products, and protocolsdocs/backlog/archive/WI-018-follow-on-public-agent-research.mddone
Define methods for the follow-on public-agent researchdocs/backlog/archive/WI-019-follow-on-research-method.mddone
Extract Letta Code — durable memory, identity, and continual learningdocs/backlog/archive/WI-020-extract-letta-code.mddone
Extract Inspect AI — reproducible agent evaluation and sandboxed evidencedocs/backlog/archive/WI-021-extract-inspect-ai.mddone
Extract Aider — git-first coding, repository context, and validationdocs/backlog/archive/WI-022-extract-aider.mddone
Extract goose — local extensibility, MCP/ACP, and session isolationdocs/backlog/archive/WI-023-extract-goose.mddone
Extract Google ADK — multi-language evolution, task delegation, and evaluationdocs/backlog/archive/WI-024-extract-google-adk.mddone
Extract MCP — the tool and context interoperability boundarydocs/backlog/archive/WI-025-extract-mcp.mddone
Extract A2A — remote agent discovery, tasks, and artifactsdocs/backlog/archive/WI-026-extract-a2a.mddone
Extract DSPy — metric-driven agent program optimizationdocs/backlog/archive/WI-027-extract-dspy.mddone
Synthesize the follow-on research and reconcile the cataloguedocs/backlog/archive/WI-028-follow-on-research-synthesis.mddone
Apply framework-derived patterns to shipped modulesdocs/backlog/archive/WI-029-apply-framework-patterns-to-modules.mddone
Refresh Rift Forge research from the candidate branchdocs/backlog/archive/WI-030-refresh-rift-forge-research.mddone
Integrate transferable Rift Forge workflow capabilities into rungsdocs/backlog/archive/WI-031-integrate-rift-forge-capabilities.mddone
Sync public docs, roadmap, and frontend surfaces with the current productdocs/backlog/archive/WI-032-sync-docs-roadmap-frontend.mddone
Assess repo quality, improvements, and external-adoption readinessdocs/backlog/archive/WI-033-assess-quality-and-adoption-readiness.mddone
Remediate release-readiness findingsdocs/backlog/archive/WI-034-remediate-readiness-findings.mddone
Prepare and execute the public rungs releasedocs/backlog/archive/WI-035-public-release.mdrejected
Port updated design-system site surfaces and prepare the next package releasedocs/backlog/archive/WI-036-design-system-versions.mddone
Act on the 2026-08-16 external reviewdocs/backlog/archive/WI-037-act-on-external-review.mddone
Make doctor report a repo's own defects, not only which modules it resemblesdocs/backlog/archive/WI-038-doctor-explain-detectors.mddone
Detect an external issue tracker as a different paradigm, not as an absent backlogdocs/backlog/archive/WI-039-external-tracker-paradigm.mddone
Make every public surface agree on the first command, and name the vocabulary oncedocs/backlog/archive/WI-040-public-surface-first-command.mddone
Decide whether cross-repo pattern evidence is ever in scope, and record itdocs/backlog/archive/WI-041-decide-cross-repo-evidence.mddone
Stop reporting `file.ts:387` code references as broken linksdocs/backlog/archive/WI-042-link-line-references.mddone
Make `add` honour a detected paradigm instead of installing over itdocs/backlog/archive/WI-043-add-honours-paradigm.mddone
Resolve the open findings registerdocs/backlog/archive/WI-044-resolve-open-findings.mddone
Execute gate self-test fixtures instead of only declaring themdocs/backlog/archive/WI-045-run-gate-self-tests.mddone
Make the site's "real output" label provable rather than asserteddocs/backlog/archive/WI-046-console-provenance.mddone
Implement `rungs backlog archive`docs/backlog/archive/WI-047-backlog-archive-command.mddone
Act on the second external reviewdocs/backlog/archive/WI-048-act-on-second-external-review.mddone
Make plain `doctor` say that the analysis existsdocs/backlog/archive/WI-049-doctor-advertises-analysis.mddone
Refuse a board row whose group disagrees with the item's statusdocs/backlog/archive/WI-050-board-reconciled-gate.mddone
Stop typing the site's gate and status numbers by handdocs/backlog/archive/WI-051-derive-site-claims.mddone
Make detector applicability a declared property rather than two listsdocs/backlog/archive/WI-052-detector-applicability.mddone
Census `--explain` against every repo available, and publish the false-positive ratedocs/backlog/archive/WI-053-false-positive-census.mddone
Make `upgrade` re-register a module's gatesdocs/backlog/archive/WI-054-upgrade-registers-gates.mddone
Make `upgrade` update the install record without touching diverged filesdocs/backlog/archive/WI-055-upgrade-updates-record.mddone
Triage the self-test mismatches, and fix what they exposeddocs/backlog/archive/WI-056-triage-selftest-mismatches.mddone
Narrow the self-test mismatches, and locate the real causedocs/backlog/archive/WI-057-selftest-setup.mddone
Implement the skill-extension opt-in, at every layer it was missing fromdocs/backlog/archive/WI-058-skill-extensions.mddone
Wire the self-test runner in, and fix the four defects that blocked itdocs/backlog/archive/WI-059-selftest-wiring.mddone
Prepare the v0.2.0 release and close the release-integrity findings it surfaceddocs/backlog/archive/WI-060-release-0.2.0.mddone
Detect imperatives and stale command references in agent instructionsdocs/backlog/archive/WI-061-imperative-staleness-detection.mddone
Decide what the concurrency module is — four commands, or the manual protocol it actually documentsdocs/backlog/archive/WI-062-concurrency-phantom-commands.mddone
Make a fresh tracked findings register pass its own gatedocs/backlog/archive/WI-065-fresh-findings-baseline.mddone
Give consumers one exact Rungs CLI version sourcedocs/backlog/archive/WI-066-consumer-cli-pin.mddone
Reconcile backlog state when the integration branch has no local refdocs/backlog/archive/WI-067-ref-only-integration-branch.mddone
Gate the packaged existing-repository consumer journeydocs/backlog/archive/WI-068-existing-repo-consumer-journey.mddone
Preserve gate-registry bytes on a no-op upgradedocs/backlog/archive/WI-069-idempotent-gate-registration.mddone
Make both release fragment gates executable and non-vacuousdocs/backlog/archive/WI-070-release-fragment-gates.mddone
Canonicalize packed-consumer containment checksdocs/backlog/archive/WI-071-canonical-consumer-paths.mddone
Track the consumed release boundarydocs/backlog/archive/WI-072-release-consumption-boundary.mddone
Contain every emitted module path inside the consumer repositorydocs/backlog/archive/WI-073-emitted-path-containment.mddone
Make release version sources format-aware and fail closeddocs/backlog/archive/WI-074-version-source-formats.mddone
Refuse landing while the integration branch is checked outdocs/backlog/archive/WI-075-land-checked-out-integration.mddone
Contain backlog archival inside the repositorydocs/backlog/archive/WI-076-backlog-archive-containment.mddone
Make ejected checks genuinely package-independentdocs/backlog/archive/WI-077-standalone-ejected-checks.mddone
Require release exemptions from the current branchdocs/backlog/archive/WI-078-branch-local-release-exemptions.mddone
Protect every land-managed ref from checked-out worktreesdocs/backlog/archive/WI-079-land-managed-ref-safety.mddone
Refuse APFS emitted-path storage aliasesdocs/backlog/archive/WI-080-apfs-emitted-path-collisions.mddone
Refuse land when detached-scratch verification lacks a trustworthy controldocs/backlog/archive/WI-081-land-scratch-verification-control.mddone
Normalize consumer text semantics without rewriting bytesdocs/backlog/archive/WI-082-consumer-crlf-normalization.mddone
Clear the site fast-uri security audit findingdocs/backlog/archive/WI-083-site-audit-fast-uri.mddone
Evaluate tool maturity, improvement candidates and a local interfacedocs/backlog/archive/WI-084-tool-evaluation.mddone
Complete the consumer promises rungs already ships or has accepteddocs/backlog/archive/WI-085-existing-promises-remediation.mddone
Deliver the declared shell-safety hook to consumers, or report that a harness cannot carry itdocs/backlog/archive/WI-086-consumer-hook-delivery.mddone
Make every shipped self-test fixture execute, or state exactly why it cannotdocs/backlog/archive/WI-087-executable-self-test-coverage.mddone
Report observed fast-tier wall-clock against the declared budgetdocs/backlog/archive/WI-088-observed-fast-budget-reporting.mddone
Keep a failed worktree status read unknown instead of reporting it cleandocs/backlog/archive/WI-089-truthful-worktree-state.mddone
Verify the integrated candidate as a packed consumer and hand the canary step to WI-064docs/backlog/archive/WI-090-integrated-consumer-verification.mddone
Stop the derived-index freshness rule counting the template's placeholder row as a recorddocs/backlog/archive/WI-091-index-placeholder-rows.mddone
Make the eject summary name every retained commanddocs/backlog/archive/WI-092-eject-summary-retained-commands.mddone
Make `add` after `init` extend the install record instead of replacing itdocs/backlog/archive/WI-093-add-merges-install-record.mddone
Make `check <tier>` mean the tier on both launcher surfacesdocs/backlog/archive/WI-094-check-tier-positional.mddone
Make the large-value assertion rule mechanical and cap the test heapdocs/backlog/archive/WI-095-guarded-large-assertions.mddone
Anchor the private inline-interpreter hook to the interpreter's own argumentsdocs/backlog/archive/WI-096-hook-flag-anchoring.mddone
Retire the design-sync gate that presupposes a command that does not existdocs/backlog/archive/WI-097-retire-phantom-design-gate.mddone
Make an interrupted install recoverable — journal first, atomic writes, a retry that keeps ownershipdocs/backlog/archive/WI-098-recoverable-install.mddone
Prepare the v0.5.0 releasedocs/backlog/archive/WI-099-release-0.5.0.mddone
Add a local interface for repository inspection and gate executiondocs/backlog/archive/WI-100-local-operator-interface.mddone
Backlogdocs/backlog/BACKLOG.md—
Findingsdocs/backlog/FINDINGS.md—
Itemsdocs/backlog/items/README.md—
Resolve modules from roots outside the package, and record where each installed module came fromdocs/backlog/items/WI-063-external-module-roots.mdproposed
Bootstrap Arena Lab as the first direct Rungs consumerdocs/backlog/items/WI-064-arena-lab-dogfood-bootstrap.mdaccepted
Validate operator workflow extensions and register admission criteriadocs/backlog/items/WI-101-operator-workflow-extensions.mdproposed
Short imperative titledocs/backlog/TEMPLATE.mdproposed
Corpus
documentsourcestatus
Your first hourdocs/getting-started.md—
Glossarydocs/glossary.md—
Roadmapdocs/roadmap.md—
Note
This registry is derived from the files in docs/ at build time, not hand-kept. A document that exists appears here; one that is deleted stops appearing. Titles come from frontmatter where there is any, and from the document's own H1 where there is not.