Skip to content

Add AI operating template (governance, specs, hooks) for 3RIC#5

Open
ebadger wants to merge 1 commit into
mainfrom
add-ai-operating-template
Open

Add AI operating template (governance, specs, hooks) for 3RIC#5
ebadger wants to merge 1 commit into
mainfrom
add-ai-operating-template

Conversation

@ebadger

@ebadger ebadger commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Applies the AIProjectTemplate "AI operating system" to this repo, localized to 3RIC / Badger6502. This is governance + docs + tooling scaffolding only — it does not touch any emulator, ROM, hardware, or web source.

What's included

  • docs/MISSION.md (the Badger6502 mission), LEARNINGS.md (canonical workflow rules §1–6 + Tier-1 digest, 5.3 KB, under budget), ROLES.md, CODE-REVIEW-PANEL.md, SUGGESTIONS.md, and the learnings/ capture scaffolding.
  • specs/SYSTEM.md umbrella (architecture diagram, memory map, critical path) linking five sub-specs authored from source: HARDWARE.md, ROMS.md, EMULATOR.md, WEB.md, DISK.md.
  • status/SYSTEM-STATUS.md — run/build/verify commands (VS Test Explorer + web node tests), no-secrets note, key scripts.
  • .github/copilot-instructions.md, the compliance-hooks Copilot extension (cross-layer nudges + learnings start-checklist), gpt/gemini reviewer agents, lens/agent skeletons, and issue/PR templates.
  • .githooks/ + scripts/dev/ — learnings-budget check, hook installer, and a pre-push-tests.sh gate.

Localized to 3RIC (not generic)

  • Stack/domain/layers describe the real project: C++17 65C02 VM core, WinUI 3 (C++/WinRT) host, Emscripten/WASM web build, MSVC unit tests, C# romgen ROM tools, KiCad/22V10/Logisim hardware, and WozLib/MockMicroSD/picodisk disk tooling.
  • The compliance extension's SPEC_PATTERNS and the cross-layer checklist target the repo's actual directories (emulator/, web/, romgen/, kicad/, logisim/, 22v10/) and the shared badger6502.bin / fontrom.dat contract.
  • The shared contract (ROM image + 6502 memory map → hardware · emulator core · WinUI host · WASM web) is documented as the critical path.

Pre-push test gate (scripts/dev/pre-push-tests.sh)

Runs the web headless node tests (web/test_*.cjs) and the C++ Badger6502VMTest suite. Fail-closed when built, fail-open when not: if a build output is missing it warns and skips rather than forcing a full build to push. SKIP_TEST_GUARD=1 git push is the escape hatch. Hooks are opt-in via scripts/dev/install-hooks.sh.

Notes / to verify

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Instantiates the AIProjectTemplate operating system into the repo: docs/ (MISSION, LEARNINGS, ROLES, CODE-REVIEW-PANEL, SUGGESTIONS + learnings scaffolding), specs/ (SYSTEM umbrella plus HARDWARE/ROMS/EMULATOR/WEB/DISK sub-specs), status/SYSTEM-STATUS, the compliance-hooks Copilot extension, reviewer + lens agent scaffolding, issue/PR templates, and a pre-push test gate.

All generic placeholders and layer language are localized to 3RIC (Badger6502): C++17 VM core, WinUI 3 (C++/WinRT) host, Emscripten/WASM web build, MSVC unit tests, C# romgen ROM tools, KiCad/22V10/Logisim hardware, and WozLib/MockMicroSD/picodisk disk tooling. The compliance SPEC_PATTERNS and cross-layer checklist target the repo's actual directories; scripts/dev/pre-push-tests.sh runs the web node tests and Badger6502VMTest, failing open when nothing is built and honoring SKIP_TEST_GUARD.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

1 participant