b38cfac760
Moves all Mosaic framework runtime files from the separate bootstrap repo into the monorepo as canonical source. The @mosaic/mosaic npm package now ships the complete framework — bin scripts, runtime configs, tools, and templates — enabling standalone installation via npm install. Structure: packages/mosaic/framework/ ├── bin/ 28 CLI scripts (mosaic, mosaic-doctor, mosaic-sync-skills, etc.) ├── runtime/ Runtime adapters (claude, codex, opencode, pi, mcp) ├── tools/ Shell tooling (git, prdy, orchestrator, quality, etc.) ├── templates/ Agent and repo templates ├── defaults/ Default identity files (AGENTS.md, STANDARDS.md, SOUL.md, etc.) ├── install.sh Legacy bash installer └── remote-install.sh One-liner remote installer Key files with Pi support and recent fixes: - bin/mosaic: launch_pi() with skills-local loop - bin/mosaic-doctor: --fix auto-wiring for all 4 harnesses - bin/mosaic-sync-skills: Pi as 4th link target, symlink-aware find - bin/mosaic-link-runtime-assets: Pi settings.json patching - bin/mosaic-migrate-local-skills: Pi skill roots, symlink find - runtime/pi/RUNTIME.md + mosaic-extension.ts Package ships 251 framework files in the npm tarball (278KB compressed).
1.9 KiB
1.9 KiB
Documentation Completion Checklist
Use this checklist for every task that changes code, API contracts, auth, or operations.
Required Artifacts
docs/PRD.mdordocs/PRD.jsonexists and is currentdocs/USER-GUIDE/updated as neededdocs/ADMIN-GUIDE/updated as neededdocs/DEVELOPER-GUIDE/updated as neededdocs/API/OPENAPI.yaml(or.json) updated for API changesdocs/API/ENDPOINTS.mdupdated for API changesdocs/SITEMAP.mdupdated for navigation changes
API Coverage
- All public endpoints are documented
- All private/internal endpoints are documented
- All API input schemas are documented
- All API output schemas are documented
- All endpoint auth/permission requirements are documented
- Error codes and failure behavior are documented
Structural Standards (Book/Chapter/Page)
docs/USER-GUIDE/README.mdindexes user chapters/pagesdocs/ADMIN-GUIDE/README.mdindexes admin chapters/pagesdocs/DEVELOPER-GUIDE/README.mdindexes developer chapters/pages
Docs Root Hygiene
docs/root is clean and only contains canonical root docs (PRD, TASKS when active, SITEMAP, optional README) plus category directories- Reports are under
docs/reports/<category>/(notdocs/root) - Deferred findings are under
docs/reports/deferred/ - Orchestrator learnings are under
docs/tasks/orchestrator-learnings.json - Release notes are under
docs/releases/ - Archived task snapshots are under
docs/tasks/ - Scratchpads are under
docs/scratchpads/
Review Gate
- Documentation changes are in the same logical change set as code/API changes
- Code review verified documentation completeness
- Missing docs were treated as blocker findings
Publishing
- Publishing target was confirmed with user if unspecified
- Canonical source remains in-repo unless user explicitly declares otherwise