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.

Repository Snapshot

• 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
• Initial preview commit: 0a6aec8e7189515c7432a6c7e9af8f3c8854c47f
• Current public README commit: a910dad38cd268ece4778829114a60b8348cb9d6
• License: MIT

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.

Graph Images

• Graphify-style context node PNG
• Graphify module graph PNG

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.