Task — engineering-spec@1
"Spec-only module manifest"
doneTASK-IMP-055
TASK-IMP-055: Spec-only module manifest
Summary
Publish an honest machine-readable + human table of which modules/* trees ship code vs docs/skills-only (deep-audit R9).
Problem
Many module folders look like packages but only carry CHANGELOG/audit stubs. Agents invent import paths that do not exist.
Proposed Solution
modules/manifest.yaml + docs/modules/MANIFEST.md listing every top-level module with ships_code or docs_skills_only.
Alternatives Considered
- Delete docs-only module folders — rejected: they still anchor task modules.
- Generate-only with no human table — rejected: agents need a readable index.
Success Metrics
- Manifest lists every
modules/*directory exactly once with a kind. - Kinds match on-disk reality for cuo/memory/skill/templates vs the rest.
Scope
In scope: yaml + markdown manifest. Out of scope: rewriting module READMEs.
AI Authorship Disclosure
- Session agent; HITL Stephen Cheng (session operator).
1. Description (normative)
- 1.1 MUST add
modules/manifest.yamlwithversion, per-moduleid+kind. - 1.2 MUST add
docs/modules/MANIFEST.mdhuman table cross-linking the yaml. - 1.3 MUST classify
cuo,memory,skill,templatesasships_codeand the remaining top-level modules asdocs_skills_onlyfor CyberOS 1.x.
2. Acceptance criteria
- [x] AC 1 (traces_to: #1.1–#1.3) - yaml + md present; module set matches
modules/* - [x] AC 2 (traces_to: #1.3) - four ships_code ids are exactly cuo/memory/skill/templates
3. Edge cases
tools/install/mcp/is not amodules/mcpcode tree — note in manifest.