glm-5.2
e6062230f9
The three architecture tasks I seeded in the previous commit used invalid enum values for the taskgraph frontmatter (level: architecture, impact: local, scope: small). Corrected to the valid taskgraph enums: level: implementation/ decomposition/planning, impact: project/component, scope: moderate/narrow. taskgraph validate now passes for tasks/architecture/. (Pre-existing tasks/call/registry/*.md and tasks/core/ownership-store-trait.md use status: done instead of completed — out of scope for this fix.)
2.3 KiB
2.3 KiB
id, name, status, depends_on, scope, risk, impact, level
| id | name | status | depends_on | scope | risk | impact | level |
|---|---|---|---|---|---|---|---|
| architecture/open-questions-decompose | Decompose open-questions.md into per-OQ files under questions/ | completed | moderate | low | project | implementation |
Description
The single docs/architecture/open-questions.md file had grown to 1310 lines
across 47 OQs — large enough to be unmanageable, with high size variance
(OQ-42 at 220 lines next to OQ-06 at 8 lines). Decomposed into one file per
OQ under docs/architecture/questions/ (NNN-slug.md, mirroring the ADR
convention), with open-questions.md retained as the index (theme-grouped
tables + a cross-theme "Deferred / Blocked" section for safe-exit visibility).
What changed
- Created
docs/architecture/questions/with 47 files (001-...mdthrough047-...md), content moved verbatim from the old monolithic file (heading rewritten from### OQ-NNto# OQ-NNfor standalone files). - Rewrote
docs/architecture/open-questions.mdas the index:- Status-values / door-type definitions preserved
- 15 theme sections, each with a table:
| OQ | Title | Status | Door | Pri | - A "Deferred / Blocked" cross-theme section surfacing the 6 deferred OQs
with their
Blocked on:conditions inline (the safe-exit visibility surface)
- Updated
docs/architecture/README.md: dropped the 65-line curated OQ summary section (replaced by the index tables), kept the doc-table row pointing atopen-questions.md. - Original monolithic file preserved at
/tmp/opencode/open-questions.old.mdfor verification.
Verification
python3 /tmp/opencode/verify_oqs.pyconfirms all 47 per-OQ files match the original content byte-for-byte (modulo the### OQ→# OQheading rewrite).- All 62 inbound links to
open-questions.mdacross ~30 files remain valid (none used#oq-NNanchors — they all point at the bare filename, which is unchanged).
Out of scope
- Re-resolving or editing any OQ content — verbatim move only.
- Fixing OQ-09/OQ-10's missing
Blocked on:field — tracked asarchitecture/oq-09-10-blocking-conditions. - Establishing the
tasks/architecture/blocker-task convention — tracked asarchitecture/safe-exit-blocker-task-mechanism. - Touching reviews/research docs that cite
open-questions.mdby line number (those citations are already stale; reviews are historical artifacts).