docs: compress README public face + add GitHub hygiene files - #14
Merged
Merged
Conversation
Opening identity becomes "an evidence-gated OS lab for agent-native computing". Add a compressed "Short Version" and promote the smoke proof to its own "Try the Smallest Proof" section; restructure contributor help into three tracks; surface a secondary Governance & Research section. Add SECURITY.md (vulnerability reporting + posture), CODE_OF_CONDUCT.md (Contributor Covenant 2.1), and GitHub issue/PR templates (bug, hardware-evidence, docs-confusion, pull request) so the public contribution flow matches the project's evidence discipline. CHANGELOG + DECISIONS entries. Docs-only: foundry gate skips on CI.
maxwellsantoro
approved these changes
Jun 25, 2026
maxwellsantoro
left a comment
Owner
There was a problem hiding this comment.
A3 approval (human, distinct from A2 author app/ramen-implementer). Docs-only public-face polish: README compression (OS-lab identity, Short Version, Try the Smallest Proof, Useful help now, Governance & Research) + 6 GitHub hygiene files (SECURITY.md, CODE_OF_CONDUCT.md, issue/PR templates). Validated: just foundry-org-governance-g0 PASS, git diff --check clean; foundry skipped on CI as docs-only. Separation of duties holds.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Public-face polish from a landing-page review: sharpens the 30-second visitor
funnel and adds the GitHub-native contribution surface the repo was missing.
Docs-only — the
foundryjob is path-scoped and will skip; this PR mergeson
org-governance+merge-gate.README compression
New GitHub hygiene files
SECURITY.md— private vulnerability reporting, "not production," posture pointers.CODE_OF_CONDUCT.md— Contributor Covenant 2.1..github/PULL_REQUEST_TEMPLATE.md— evidence level, claim-boundary checklist, separation of duties..github/ISSUE_TEMPLATE/{bug_report,hardware_evidence_report,docs_confusion}.md— the hardware-evidence template capturesclaim_path, appliance id, and provenance flags.Not in this PR
Validation
git diff --check— clean.just foundry-org-governance-g0— PASS (status_drift + all 19 metrics)..rs/.toml/.idl/rust-toolchainchanges →foundryskips on CI.Separation of duties
Opened by
ramen-implementer[bot](A2); awaits approval + merge by a differentidentity (A3).