Home

Agent Bootstrap Preview Wiki

Agent Bootstrap Preview is a sanitized public-review snapshot of a local-first governance toolkit for coding agents.

The preview focuses on one practical problem: before an agent edits durable repository files, it should be anchored to an explicit GitHub issue, checklist, validation contract, and architecture boundary. The included scripts, policies, skills, and templates show one implementation of that workflow.

Start Here

• Public Preview Scope explains what is included and what was intentionally excluded.
• Workflow Overview explains the end-to-end agent governance flow.
• Context Injection And Graphify compares Mermaid workflow diagrams with Graphify-style explainable context nodes.
• Architecture Boundary describes the responsibility map and dependency direction.
• Reviewer Quick Start shows how to run the public smoke tests.
• Validation Evidence records the local and GitHub Actions validation status.
• Sanitization Checklist lists the public-safety checks used before publication.

Current Release

• Repository: ClarusIubar/agent_bootstrap-preview
• Current visibility: public
• Preparation mode: private until the sanitized snapshot was reviewed
• Fork status: not a fork
• Default branch: main
• Current preview release: v0.3.0-preview.1
• Source anchor: ClarusIubar/agent_bootstrap@v1.4.0-rc.1
• Source commit: d6cf6e68e2abd2cbe432903380a72968533ef9fe
• Runtime anchor: ClarusIubar/agent-governance-runtime@v0.1.1
• Runtime access: private runtime wheel access is required for direct wheel download
• License: MIT

Read Release-v0.3.0-Preview-Boundary before treating this repository as a current preview snapshot.

Install / Review

This repository is a public review snapshot. Clone it, read the README, and run the public smoke tests. Direct runtime wheel installation requires private access to ClarusIubar/agent-governance-runtime.

python -m compileall -q scripts
python -m pytest tests -q

Public Preview Contract

• The preview documents the local governance harness surface.
• It does not grant access to private runtime wheel artifacts.
• It does not include private issue, PR, CI, merge, completion, or machine-local evidence ledgers.
• It does not implement the shared multi-machine control plane.

Stable / Preview / Dev Boundary

• Stable upstream: agent_bootstrap v1.3.0
• Bootstrap release candidate anchor: agent_bootstrap v1.4.0-rc.1
• Public preview release: agent_bootstrap-preview v0.3.0-preview.1
• Runtime anchor: agent-governance-runtime v0.1.1
• Dev surfaces remain in the private operational repositories.

Authority Boundary and Source of Truth

In the operational workflow, GitHub issue/checklist/PR/CI/merge readback remains the source of truth. Local registry/focus, qmd, Hermes, Graphify, runtime projections, and Wiki pages are cache, context, evidence, or readback aids only.

Validation and Release Evidence

• Release: Release-v0.3.0-Preview-Boundary
• PR: #5
• Digest correction PR: #6
• CI test: passed
• CodeQL: passed
• Public smoke tests: 5 passed
• Runtime wheel SHA-256: 05e88dda504d8f3dbf682dd459a25f7809b595292135207f92156ea06d5ad37f

Roadmap

• Keep the public preview sanitized and reviewable.
• Promote future preview snapshots only after runtime and bootstrap anchors are fixed.
• Do not present this repository as a fully standalone runtime distribution while the runtime wheel is private.

Included Surfaces

• Python CLI and helper modules under scripts/
• Governance policies under policies/
• Reusable engineering skills under registry/skills/
• Managed shim templates under templates/shims/
• Public reviewer documentation under README.md and docs/
• Public smoke tests under tests/

Core Workflow In One Sentence

The toolkit turns "please implement this" into a gated workflow: bind a real GitHub child issue, hydrate its checklist and validation contract, allow edits only inside that scope, run local and remote validation, record completion evidence, and only then finish the task.

Previous v0.2.0 Release Focus

The previous v0.2.0 preview refresh updated the allowlisted CLI, policy, skill registry, and shim-template surface while keeping private operational history, issue/pull request readbacks, local state, token-like fixtures, and non-public runner workflows out of the public repository. Current architecture diagrams are maintained as Mermaid blocks in Architecture Boundary and Context Injection And Graphify.

v0.3.0-preview.1 Release Focus

The v0.3.0 preview refresh anchors the public snapshot to agent_bootstrap@v1.4.0-rc.1 and agent-governance-runtime@v0.1.1. It keeps the scope limited to local governance compliance and documents that the runtime wheel remains private.

Architecture Diagrams

The preview Wiki uses Mermaid diagrams instead of external image assets so the architecture remains visible inside GitHub Wiki pages.

• Architecture Boundary shows the layered authority and dependency model.
• Context Injection And Graphify shows the workflow graph, context graph, and module boundary graph as Mermaid diagrams.

Excluded Surfaces

• Source repository Git history
• Private issue, pull request, CI, merge, and completion evidence ledgers
• Machine-local state such as .local/
• Cache, temporary, and coverage artifacts
• Token-like fixtures and non-public workflow traces

Public Conversion

The repository was prepared while private, reviewed as a sanitized snapshot, and then switched to public visibility for external review.