Impossible OS Docs
Infrastructure
Build system, CI/CD pipelines, tooling, and development environment.
Roadmap Overviews
One page per infrastructure roadmap file, each following the page contract.
| Document | Topics |
|---|---|
| Developer Tooling Stack | Setup, build, test, lint and run wrappers, hooks, tooling doctor |
| AI Development System | Doctrine, skills, hooks, reviewer contract, AI regression pack |
| Kernel Test Harness | In-kernel unit tests, fault injection, race barrier, leak detection |
| User-Mode Test Framework | test_*.exe binaries, launcher, TAP, JUnit XML and JSON output |
| Desktop and UI Test Framework | Screen capture, input injection, visual regression, frame timing |
| TODO Metadata Layer and Graph | Roadmap frontmatter, derived cache, queries, MCP server |
| LSP to MCP Bridge | Language servers as read-only MCP tools for AI agents |
| Automation Hardening | Commit and review gates, hook audits, Codex policy |
| Repository Ownership and Transfers | Where the repository lives, transfer runbooks, owner-reference checks |
Reference Documents
| Document | Topics |
|---|---|
| Development Tooling | Build system, Makefile, Clang toolchain, asset pipeline, test framework |
| AI Development System | Claude Code + Codex ownership map, Authority Hierarchy, edit-here-not-there rules |
| Skill Authoring Lifecycle | How to add/edit/retire a Claude Code skill, canonical SKILL.md template, catalog hygiene sync rules |
| TODO Frontmatter Spec | Canonical YAML frontmatter for todo/**/*.md: required + optional + auto-derived fields, parsing rules |
| GitHub Setup | CI/CD workflows, GitHub Actions, issue templates, labels, branch protection |
See Also
- Getting Started -- QEMU and VirtualBox setup guides