Skip to content

Expose docs bootstrap contracts - #92

Merged
chubes4 merged 2 commits into
mainfrom
expose-bootstrap-contract
Jun 13, 2026
Merged

Expose docs bootstrap contracts#92
chubes4 merged 2 commits into
mainfrom
expose-bootstrap-contract

Conversation

@chubes4

@chubes4 chubes4 commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add a bootstrap_contract JSON input to maintain-docs.yml, normalize it during prepare, render it into bootstrap prompts as success criteria, and pass it through as post_run_workspace_checks.
  • Teach technical and user bootstrap prompts that caller-declared contracts are required completion criteria, including no_changes semantics.
  • Extend bundle validation to assert complete bootstrap contract semantics and reject deferred/backlog language.

Issue

Dependency

Verification

  • jq empty bundles/technical-docs-agent/flows/technical-docs-bootstrap-flow.json bundles/user-docs-agent/flows/user-docs-bootstrap-flow.json bundles/technical-docs-agent/pipelines/technical-docs-pipeline.json bundles/user-docs-agent/pipelines/user-docs-pipeline.json tests/docs-agent.validate-bundle-spec.json tests/technical-docs-agent.validate-bundle-spec.json tests/user-docs-agent.validate-bundle-spec.json
  • php tests/validate-docs-agent-bundle.php
  • php tests/repair-docs-links-smoke.php

AI assistance

  • AI assistance: Yes
  • Tool(s): OpenCode (GPT-5.5)
  • Used for: Implemented the workflow contract plumbing, prompt updates, validation assertions, and local verification; Chris remains responsible for review and merge.

@chubes4
chubes4 merged commit 713dd7b into main Jun 13, 2026
@chubes4
chubes4 deleted the expose-bootstrap-contract branch June 13, 2026 00:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Expose deterministic docs bootstrap contract inputs

1 participant