Skip to content

INDEX.md

Latest commit

 

History

History
364 lines (320 loc) · 28.2 KB

INDEX.md

File metadata and controls

364 lines (320 loc) · 28.2 KB
Raw
title The archive index and status dashboard
category Documentation root
kind standard
date 2026-10-22
status active
registry Documentation/INDEX.md
statuses
name state evidence
the single document template (YAML frontmatter)
implemented
Documentation/ARCHIVE-STYLE.md; applied to every document below
name state evidence
the folder restructure (Plans/Researches/Guides/Reports/Plugins/Archive)
implemented
this tree; the moves kept every byte
name state evidence
the granular split (the large plans/researches as per-topic subdocuments)
implemented
Plans/Batch-Edit-Tool (19), Plans/Representation-First (14), Plans/UI-Family (14), Plans/Workspace-Family (25), Archive/Tomorrow-Review (8) - the parents became hubs; every section preserved
name state evidence
the cross-reference updates to the new paths
implemented
the hub parents kept their paths - no external reference broke; the subdocs cross-link to their hubs
name state evidence
Handoff/ and Skill/ untouched
resolved
preserved in place (the delivery record; the loadable skills)
name state evidence
the per-document status derivation from actual state
implemented
sourced from this session's record, git log, the runner's last line, and the built site

INDEX - The Documentation Archive

The archive index: EVERY document in the Documentation tree, its category, and its document-level status. The template (the single style) is Documentation/ARCHIVE-STYLE.md - the YAML frontmatter schema EVERY document carries. Statuses are derived from the ACTUAL state: Documentation/Plans/TOMORROW-REVIEW.md (the full record), the git log, the runner (node Maintain/Run/Smokes/Index.mjs), and the built site.

1. The tree

Documentation/
  INDEX.md                     this index
  ARCHIVE-STYLE.md             the single template (the frontmatter schema)
  FRAMEWORK.md                 the distilled requirements + the skill framework
  Brand/BRANDING.md            the brand brief
  Brand/ICON-GRAMMAR.md        the generated icon language (sheet -> genome -> SVG)
  Brand/ICON-REFERENCE.md      the 29 reference motifs, cut out and read one by one
  Brand/ICON-METHODS.md        the construction methods (open strokes, cusps, tapers) and their dispersal
  Plans/                       the living + queued plans (32) + 5 granular families (80)
    Batch-Edit-Tool/           the batch edit tool's granular topics (19)
    Representation-First/      the representation-first research's topics (14)
    UI-Family/                 the UI family plan's phases (14)
    Workspace-Family/          the workspace family's per-package docs (26)
  Researches/                  the research outputs (8)
  Guides/                      the operating manuals (7)
  Reports/                     the audits and diagnoses (6)
  Plugins/                     the registry documents (4)
  Testing/                     the per-plugin live test plans (35)
  Archive/                     the one-shot records (45, in 8 topics)
    Smoke-Restructure/  Site/  Live-Containers/  Tool-Coach/
    Split/  CCR/  Normalize/  Tomorrow-Review/
  Handoff/                     (untouched) the original delivery record
  Skill/                       (untouched) the loadable skills

2. The registry

Documentation root (3)

Document Status Kind
ARCHIVE-STYLE.md active standard
FRAMEWORK.md active living-record
INDEX.md active standard

Brand (4)

Document Status Kind
Brand/BRANDING.md active living-record
Brand/ICON-GRAMMAR.md active living-record
Brand/ICON-METHODS.md active living-record
Brand/ICON-REFERENCE.md active living-record

Plans - the living + queued hubs (32)

Document (Documentation/Plans/) Status Kind
TOMORROW-REVIEW.md active living-record
DSH-MONOREPO-PLAN.md active living-plan
BATCH-EDIT-TOOL-FEATURE.md active living-plan (R-BET-1 hub)
BATCH-EDIT-TOOL-SUGGESTIONS.md active living-record (R-BET-2 hub)
REPRESENTATION-FIRST-WORKSPACE-RESEARCH.md complete research-output (hub)
WORKSPACE-PLUGIN-FAMILY-DECOMPOSITION.md superseded living-plan (hub; the v4.1 distilled)
UI-FAMILY-IMPLEMENTATION-PLAN.md superseded queued-plan (hub; the v4.1 distilled)
ORCHESTRATION-FAMILY.md implemented (PoC) queued-plan (the orchestration family's design record)
BATCH-STATE-PLUGIN.md implemented (PoC) queued-plan
ROUTING-ENFORCER-PLUGIN.md implemented (PoC) queued-plan
SUBAGENT-QUEUE-PLUGIN.md implemented (PoC) queued-plan
HONEST-FEEDBACK-PLUGIN.md implemented (PoC) queued-plan
APHRODITE-RUST-DYLIB-INTEGRATION.md planned queued-plan
APHRODITE-TOOL-COMPRESSION-PLUGIN.md planned queued-plan
TRUSTED-PUBLISHER.md planned queued-plan
RELEASE-0.1.0.md active one-shot-record (the release runbook)
RELEASE-0.2.0.md active one-shot-record (the 0.2.0 release runbook)
PATTERN-GRAPH-PLUGIN.md implemented (PoC) queued-plan (the general suggestion model)
SEARCH-SUGGESTER-PLUGIN.md implemented (PoC) queued-plan (the pattern graph's first consumer)
PASS-ON-AND-INGESTER.md implemented (PoC) queued-plan (the batch decision flow)
COST-TRACK-PLUGIN.md active living-plan
SQL-FILES-RFC.md planned queued-plan (the SQL-files refactor)
RFC-DRIFT-GATE.md planned queued-plan (the fallback generator)
RFC-SMOKE-AGGREGATE.md planned queued-plan (the Source-vs-Target audit)
RFC-PUBLICATION.md planned queued-plan (the 0.3.0 release staging)
RFC-CONVERSATION-SPINE.md planned queued-plan (the conversation bus)
SITE-POLISH-BREAKDOWN.md planned queued-plan (site content and wording)
FAMILY-ORGANISATION-ANALYSIS.md planned queued-plan (duplication, functionality, placement)
IMPLEMENTATION-WAVE-1.md active living-plan (the decision record and workstreams)
UI-FAMILY-V4-1.md active living-plan (the visual panel distilled)
WORKSPACE-FAMILY-V4-1.md active living-plan (the dynamic workspace distilled)
POC-BRIEF.md complete living-plan (the PoC-first delivery brief)
POC-LEDGER.md active living-record (the live matrix of the planned suite)
COMPLETION-SPEC active living-plan (the completion program's hub)
ETS-TWINS-BRIEF.md complete living-plan (the 29-30 ETS twins' mirror brief)
SMOKE-PASS-BRIEF.md complete living-plan (the smoke pass brief)
SITE-UPDATE-SPEC.md active living-plan (the site's per-file content delta)
SITE-OBSERVATORY.md active working-plan (the site overhaul's requirement ledger)
SKILL-LEARN-PLUGIN.md active living-plan

Plans/Batch-Edit-Tool - the batch edit tool's granular topics (19)

R-BET-1 topics: VISION-AND-REPRESENTATION (the why + the representation contract) · EVICTION (the four triggers) · PARADIGM-CATALOG (13 paradigms ranked) · FEASIBILITY (the verdict + the seams) · SCHEMA (the input schema + Process) · STATE-MACHINE (the events + the ledger contract) · STATE-PRESENTATION · LIVE-VIEW-FRAMEWORK · PACKAGE-AND-GOVERNANCE (the anatomy + the govern marker) · ACCEPTANCE-CRITERIA (10 checks) · RESIDUALS (7 open) · LATER-STAGES (the graph, the code-block, the token-waste). R-BET-2 topics: PARADIGM-DEEPENING (the call-escape WHY verbatim + the type system) · FORMS-AND-GOVERNANCE-LAYERS (the nine forms + the five layers) · IMPROVEMENTS-OVER-BASH-SED · COUNTER-INTUITIVE-IDEAS · RANKED-SUGGESTIONS (14 ranked) · RESIDUALS-AND-MERGE-POINT. Evidence: TRAJECTORY-EVIDENCE (the measured cost of one-edit-at-a-time - the single owner of the figures).

Plans/Representation-First - the research's topics (14)

Round 1: FRAMING-AND-LAYERS · RESEARCH-QUESTIONS-AND-EXPERIMENT. Round 2: INVERSION-AND-CONTRACTS · VIEWS-LENSES-AUTHORITY · EVICTION-AND-PROPOSALS · RECOVERY-FAIL-OPEN-MEASUREMENT. Round 3: RUNTIME-AND-TRUTH · CANDIDATES-AND-BOUNDARIES · APPROVAL-GUARANTEES-FAILURES. Round 4: RECONCILIATION-MANDATE · COMMIT-GOVERNANCE-AND-RECOVERY · AUTHORITY-AND-EVIDENCE · ORCHESTRATION-AND-INTEGRATION-FIXES · NEXT-SLICE.

Plans/UI-Family - the implementation plan's phases (14)

BRIEF · PHASE-0-ORIENTATION · PHASE-1-SITE-COMMIT · PHASE-2-PANEL-CONTRACT · PHASE-3-FIRST-ADAPTER · PHASE-4-OPTIONS-FORMS · PHASE-5-ADAPTERS-AND-LEDGER-TAILS · PHASE-6-INTERACTION-IMPROVEMENTS · PHASE-7-PLAIN-FIELD-BRIDGE · RISKS-AND-MITIGATIONS · STATUS-LEDGER · EXTENSIONS · APPENDIX-INSPECT-CAPTURES · ONE-PARAGRAPH-SUMMARY.

Plans/Workspace-Family - the decomposition's per-package docs (26)

Frame: NAMING-BY-ROLE · PHASED-DELIVERY · INVERSE-REPRESENTATION · ANY-FILE-ADAPTERS · DATABASES-AND-CLOUD · PITFALLS-LOG · RFC-QUEUE · RESEARCH-PLACES · WAVE-1-BRIEF (the delivery wave's brief). Packages: WORKSPACE-AGENT (the agent) · OBSERVE · SEMANTICS · OPERATE · GOVERN · AUTHORITY · JOURNAL · LIVE · MERGE · MONITOR · CONTEXT · APPROVE · AUDIT · EVIDENCE · GRAPH (later stage) · REFLECT (later stage) · SHARED-LIBRARY (lib-dsh-workspace-live).

Plans/Completion-Spec - the completion program's topics (7)

00-OVERVIEW (the interview decisions, the architecture, the waves, the re-spec candidates) · 01-WORKSPACE-AND-INDEXER (the 16 workspace packages + the trace bus + the packs) · 02-ORCHESTRATION (the 10 orchestration packages + the policy block) · 03-SUGGESTERS (the 7 suggesters + the decision layer) · 04-CLIENT (the 3 client packages) · 05-CORE-EXISTING-ETS (the core, the factory, the 14 existing plugins, the twins) · 06-VERIFICATION (the acceptance bar, the activation loop, the dogfood scenarios).

Researches - the research outputs (9)

Document (Documentation/Researches/) Status Kind
AGENT-TUNER-RESEARCH.md complete research-output
FAMILY-INTERACTIONS-RESEARCH.md complete research-output
HARNESS-UI-PLUGIN-RESEARCH.md complete research-output
HARNESS-UI-OPTIONS-RESEARCH.md complete research-output
HARNESS-UI-TRAJECTORY-RESEARCH.md complete research-output
NORMALIZE-GRANULAR-CONFIG-RESEARCH.md complete research-output
NORMALIZE-OVERPASS-RESEARCH.md complete research-output
TOOL-COACH-RESEARCH.md complete research-output
INFERENCE-COST-ATTRIBUTION.md complete research-output

Guides - the operating manuals (7)

Document (Documentation/Guides/) Status Kind
DOGFOOD-TESTING.md active guide
DSH-REGISTRY-LISTING.md active guide
Governor-CASCADES.md active guide
Governor-README.md active guide
Governor-SCHEME.md active guide
Governor-TRIO-GRAPH.md active guide
LIVE-TESTING-METHODOLOGY.md active guide

Reports - the audits and diagnoses (6)

Document (Documentation/Reports/) Status Kind
CASE-REVIEW.md complete report
Commonalization-AUDIT.md complete report
FileContent-FLAVOR-DESIGN.md complete report
FSOBSERVED-DELIVERY.md complete report
P5-V2-DIAGNOSIS.md complete report
POC-GAP-ANALYSIS.md complete report (the PoC-vs-plan grades)

Plugins - the registry documents (4)

Document (Documentation/Plugins/) Status Kind
PLUGIN-FAMILY.md active living-record (the 101-package registry)
ORCHESTRATION-PLUGINS.md active living-record (built as PoCs)
PLUGIN-SUITE-SUMMARY.md active standard (the one-file suite summary, incl. the trace and pack libraries)
MARKETPLACE.md active standard (the static market index, its URL and the release step)

Testing - the per-plugin live test plans (35)

The shared methodology + one plan per plugin: README.md (the activation check, the T1-T5 tiers, the fix loop, the safety rules) and 35 per-plugin files (Documentation/Testing/<package>.md) with the exact triggers, expected outputs, known gaps and the fix paths.

Archive - the one-shot records (45, by topic)

Archive/Smoke-Restructure (2): SMOKE-SUITE-RESTRUCTURE-NOTE.md · SMOKE-SUITE-RESTRUCTURE-BLUEPRINT.md - both complete, one-shot-records.

Archive/Site (3): SITE-UPDATE-NOTE.md · SITE-UPDATE-BLUEPRINT.md · CASE-STUDY-PLAN.md - all complete.

Archive/Live-Containers (17): LIVE-CONTAINERS-RESEARCH.md; Requirements: 00-OVERVIEW · 01-LIVE-TOOL-CALL-BLOCKS · 02-PLANTED-BLOCKS · 03-BLOCK-TEMPLATES · 04-TASK-FAILSAFES · 05-MINI-CONVERSATION-SUGGESTER · 06-BETTER-IDEAS · 07-SEAM-MAP · 08-LIVE-FILE-MONITORS; Design: IMPLEMENTATION-DESIGN · FILE-MONITORS-DESIGN · APPEND-SEAM · AWAIT-MARKER · COMPLETION-ERGONOMICS · PLANTED-LEASE · SUGGESTER-CONFIGURED - all complete.

Archive/Tool-Coach (2): TOOL-COACH-PLAN.md · TOOL-COACH-OPERATIVE-PLAN.md - both complete.

Archive/Split (2): SPLICE-ETS.md (complete) · DUAL-SOURCE-BUNDLING.md (superseded).

Archive/CCR (2): CCR-FAMILY-GAP-REPORT.md · CCR-PROFILE-WIRING.md - both complete.

Archive/Normalize (1): NORMALIZE-GRANULAR-PLAN.md - complete.

Archive/Tomorrow-Review (16) - the descriptive plan's granular topics (byte-preserved copies; the master record Documentation/Plans/TOMORROW-REVIEW.md remains the authoritative source): CURRENT-STATE-2026-10-07 · IN-FLIGHT-WORK-2026-10-07 · MISSING-AND-OPEN-DECISIONS · TOMORROWS-PROCESS · RUNNING-FACTS · NEXT-BATCH-2026-10-08 · APHRODITE-WEBSITE-SESSION · BATCH-COMPLETE-AND-SLIP-2026-10-09. The chronological batch log's per-topic records (distilled from the dated sections, 2026-10-19/20): BATCH-LOG-RESTRUCTURE-2026-10-19 · BATCH-LOG-SITE-UPDATE-2026-10-19 · BATCH-LOG-LIVE-CONTAINERS-2026-10-19 · BATCH-LOG-DEPENDENCY-UPGRADE-2026-10-20 · BATCH-LOG-LIVE-TESTING-2026-10-20 · BATCH-LOG-ALIAS-SWEEP-2026-10-20 · BATCH-LOG-ARCHIVE-AND-SKILL-RESTRUCTURE-2026-10-20 · BATCH-LOG-FEATURE-LOG-2026-10-20.

3. Untouched trees

Tree Why untouched
Handoff/ the original delivery record, referenced by path from the guides
Skill/ the loadable skills home - the filesystem provider discovers these paths

4. The granular split (old body -> new home)

  • Documentation/Plans/BATCH-EDIT-TOOL-FEATURE.md (R-BET-1) -> 12 topics under Documentation/Plans/Batch-Edit-Tool/; the parent kept as the hub (the map + the reading order).
  • Documentation/Plans/BATCH-EDIT-TOOL-SUGGESTIONS.md (R-BET-2) -> 6 topics under Documentation/Plans/Batch-Edit-Tool/; the parent kept as the hub.
  • Documentation/Plans/REPRESENTATION-FIRST-WORKSPACE-RESEARCH.md (4 rounds) -> 14 topics under Documentation/Plans/Representation-First/; the parent kept as the hub.
  • Documentation/Plans/WORKSPACE-PLUGIN-FAMILY-DECOMPOSITION.md -> 25 per-package/frame docs under Documentation/Plans/Workspace-Family/; the parent kept as the hub (the family map).
  • Documentation/Plans/UI-FAMILY-IMPLEMENTATION-PLAN.md (the brief + 8 phases + risks + status + extensions + 2 appendices) -> 14 docs under Documentation/Plans/UI-Family/; the parent kept as the hub.
  • Documentation/Plans/TOMORROW-REVIEW.md sections 1-9 -> 8 topics under Documentation/Archive/Tomorrow-Review/ (byte-preserved copies); the master log stays intact and authoritative. The chronological batch log (the dated sections from "QUEUE ADDITION (2026-10-19)" onward) -> 8 per-topic records under the same folder (the BATCH-LOG-* series, distilled per-topic views; the master log stays the authoritative source).