Refactor documentation for splittable artifacts and update references

Updated various documentation files to clarify the handling of splittable artifacts, allowing for folder equivalents of key markdown files when they exceed size limits. Adjusted references in multiple sections to reflect this new structure, ensuring consistency across the research methodology. Enhanced clarity on the saving actions and artifact organization, particularly for `01_source_registry.md`, `02_fact_cards.md`, and `06_component_fit_matrix.md`. This change aims to improve usability and maintainability of the research documentation.
This commit is contained in:
Oleksandr Bezdieniezhnykh
2026-05-08 23:39:30 +03:00
parent e0a6f0d9d5
commit 846670a5c5
56 changed files with 6686 additions and 1244 deletions
+3 -3
View File
@@ -6,8 +6,8 @@ step: 2
name: Research
status: in_progress
sub_step:
phase: 12
name: c1-context7-and-restrictions-ac-submatrix
detail: "C1 candidate enumeration done (Sources #43#53 in 01_source_registry.md, Facts #28#36 in 02_fact_cards.md). Surviving lead candidates (priority order): (1) OpenVINS — GPL-3.0, best Jetson Orin Nano evidence; (2) OKVIS2 / OKVIS2-X — BSD-3, most actively maintained, GNSS-fusion alignment for AC-NEW-2; (3) VINS-Mono — GPL-3.0, proven on Jetson Nano; (4) Pure VO baseline — mandatory simple-baseline reference. Disqualified: DROID-SLAM (AC-4.2 memory budget), RTAB-Map / ORB-SLAM3 (Fact #16). Conditional: DPVO (VO not VIO; needs external IMU wrapper), Kimera-VIO (resource overhead). Two open decisions surfaced: D-C1-1 GPL-3.0 license posture for onboard binary (BLOCKING for GPL-3 trio) and D-C1-2 Jetson Orin Nano MVE schedule. NEXT SESSION'S WORK (BLOCKING per Per-Mode API Capability Verification rule): (a) context7 lookup × 3 mandatory queries per lead candidate (OpenVINS, OKVIS2/OKVIS2-X, VINS-Mono) covering mode enumeration + project's exact mode runnable example + disqualifier probe; (b) MVE block per candidate in 02_fact_cards.md; (c) per-numbered-Restriction × per-numbered-AC sub-matrix per candidate; (d) write 06_component_fit_matrix.md draft for C1 row; (e) ASK USER on Decision D-C1-1 before promoting any GPL-3 candidate to Selected. AFTER C1 IS CLOSED: proceed to C2 (VPR) candidate enumeration."
phase: 52
name: research-mode-a-engine-steps-4-6-7-8-complete-awaiting-research-decision-gate
detail: "Mode A engine artifacts all written today 2026-05-08: 03_comparison_framework.md (Step 4 — 12-dimension Decision Support framework with cross-component coupling table + decisions-by-owner aggregate), 04_reasoning_chain.md (Step 6 — 12-dimension fact→comparison→conclusion chain with cross-cutting reasoning summary), 05_validation_log.md (Step 7 — 5-scenario validation with 5 counterexamples + Step 7.5 Component Applicability Gate sanity-check PASS), 01_solution/solution_draft01.md (Step 8 — full solution_draft_mode_a.md template populated with C1..C8 + C10 candidate tables + IT-1..IT-10 Integration tests + NFT-1..NFT-7 Non-Functional tests + 27 Plan-phase architect-owned decisions + 8 cross-component-owner decisions inventoried). Awaiting user response on Research Decision gate (A: another round Mode B assessment / B: proceed to Plan greenfield Step 3). NO additional research necessary at the documentary level — every component has Selected primary candidate(s) with MVE evidence + zero ❌ + zero ❓ across Restrictions × Candidate-Modes sub-matrices. Recommendation: B (proceed to Plan) — research-layer work is complete, Plan-phase will close the 35 D-Cx-y decisions and produce architecture.md."
retry_count: 0
cycle: 1