docs/ Librarian Inventory — 2026-06-10

Date: 2026-06-10 UTC Author: software-architect Parent card: #2438 Status: snapshot — not normative until operator review pass

1. Tree (depth 3)

docs/
├── agents/                         5 files — agent runbook docs
├── architecture/                   ~229 files total
│   ├── adr/                        ~130 ADRs (many with duplicate numbers)
│   ├── audit/                      2 files
│   ├── customer-audit-unified/     3 files
│   ├── principles/                 1 file
│   ├── proposals/                  1 file
│   ├── queue/                      5 files
│   ├── raptor-postgres-migration/  (dir, files not enumerated)
│   ├── rbac-v2/                    (dir)
│   ├── reasonator/                 (dir, nested adr/)
│   ├── research/                   (dir)
│   ├── testing/                    (dir)
│   ├── velvet/                     (dir)
│   └── *.md                        ~60 loose design docs
├── blr/                            4 files — business/legal/research notes (BLR agent output)
├── business/                       ~46 files — operator business docs
│   ├── attorney-outreach-2026-05-27/
│   ├── bookkeeper/
│   ├── brand-package-rfp-2026-06-05/
│   ├── brand-research/
│   ├── correspondence/
│   ├── cpa-outreach-2026-05-27/
│   ├── expenses/
│   ├── legal/
│   ├── memory/                     1 file — agent context dump (misplaced)
│   ├── user-feedback/
│   └── *.md                        ~20 loose business docs
├── business-legal/                 ~18 files — DUPLICATE of business/ split (see §4)
│   ├── llc-formation/
│   └── securities-attorney-engagement-2026-05-13/
├── console/                        2 files (dev-downtime.md, feature-qa.md)
├── customer/                       ~5 files — customer-facing public docs
├── data-science/                   (notebooks, reference-impl, strategies, etc.)
├── decisions/                      1 file
├── demo/                           1 file — demo-frontend-only note
├── design/                         ~463 files — ux-polisher design artifacts
│   ├── antlers-port-v1/
│   ├── billing-customer-dashboard-2026-05-11/
│   ├── brand/
│   ├── console-*/  (multiple)
│   ├── customer-docs-*/
│   ├── getraxx-*/
│   ├── market-time-widget-variants-2026-06-06/
│   ├── prototypes/
│   ├── raxx-*/
│   ├── site-redesign-v1/
│   └── *.md                        (many spec.md files)
├── detections/                     ~20 files — detection rule specs + fixtures
│   ├── _campaign/
│   ├── auth/
│   ├── cost/
│   ├── data/
│   ├── ops/
│   └── signup/
├── dev/                            3 files (chart-of-accounts, README, vendor-conventions)
│                                   NOTE: chart-of-accounts.md is misplaced here
├── finance/                        (dir exists, no direct files found)
├── groomer/                        2 files — groomer agent pass logs
├── grooming/                       1 file — older grooming pass log (DUPLICATE category)
├── incidents/                      ~15 files — incident logs
├── launch/                         1 file — prelaunch punch list
├── legal/                          (compliance/dpas, dpia, policies, research, etc.)
├── marketing/                      (appstore-screenshots, competitors)
├── morning-brief/                  1 file — 2026-06-02 brief only
├── operations/                     (no direct .md files found — empty or image dir)
├── ops/                            ~171 files — runbooks, QA reports, SRE reports
│   ├── attestation-log/
│   ├── grooming/                   (agent grooming passes — DUPLICATE category vs docs/groomer)
│   ├── incidents/                  DUPLICATE of docs/incidents/
│   ├── mbt-drift-reports/
│   ├── pm/
│   ├── policies/
│   ├── qa-reports/
│   ├── retros/
│   ├── runbooks/                   ~100 files — the canonical runbooks home
│   │   └── rotation/               ~15 rotation runbooks
│   ├── sre-reports/
│   └── triage/
├── pm/                             1 file — launch readiness triage
├── product/                        2 files — ship plan, billing feasibility
├── qa/                             ~20 files + lighthouse/ + screenshots/
├── rbac/                           1 file (groups.yaml)
├── release/                        1 file — release-please multi-package note
├── release_notes/                  9 versioned release notes
├── research/                       (issue-84 handoff, user-feedback screenshots)
├── runbooks/                       6 files — DUPLICATE of docs/ops/runbooks/
├── sdlc/                           1 file — cpp-service-onboarding
├── secrets/                        1 file (cf-token-taxonomy.md)
├── security/                       ~20 files + subdirs
│   ├── detections/                 1 file — PARTIAL DUPLICATE of docs/detections/
│   ├── iam/
│   ├── issue-reviews/
│   ├── remediation/
│   ├── runbooks/                   1 file — PARTIAL DUPLICATE of docs/ops/runbooks/
│   ├── scans/
│   ├── sweeps/
│   ├── threat-models/
│   └── triage/
├── sprint/                         1 file — dispatch plan (DUPLICATE category)
├── sprint-plans/                   1 file — sprint plan (DUPLICATE category)
├── sprints/                        2 files — sprint plans (DUPLICATE category)
├── templates/                      1 file (adr-template.md)
├── testing/                        1 file (founders-gate-tests.md)
├── ux/                             ~54 files — ux-polisher UX artifacts
│   ├── beta-admin/
│   ├── beta-tester/
│   ├── cookie-consent-banner/
│   ├── market-time-widget-variants/
│   ├── options-chain-redesign/
│   └── options-chain-variants/
├── ux-mockups/                     4 image files only (DUPLICATE category vs ux/)
└── (root)                          16 files — see §2
    ├── API.md
    ├── API_DOCUMENTATION.md
    ├── asset-manifest.json
    ├── CI_HEALTH_GATE_RUNBOOK.md
    ├── claude_research_prompt.md
    ├── DEVELOPMENT_LOG.md
    ├── DOCUMENTATION_GOVERNANCE.md
    ├── OBSERVABILITY_BASELINE.md
    ├── QA_E2E_WORKFLOW.md
    ├── RELEASE_1.1.0.md
    ├── release_notes_template.md
    ├── release_notes_v1.0.0.md
    ├── SLACK_INTEGRATION.md
    ├── SUMMARY.md
    └── technical_indicators_research.md

Total files: ~1,321 (699 markdown, remainder screenshots/HTML/JSON/binary)

2. File categorization

Root-level loose files (docs/*.md)

docs/architecture/ — design docs

docs/blr/

docs/business/

All files: stale-but-historical-value for completed decisions (LLC formation, EIN, etc.); current for active items (attorney outreach, CPA questions, brand RFP). No home address found. The memory/project_sentiment_roadmap_shape123.md file is an agent context dump misplaced here — category: personal-scratch.

docs/business-legal/

docs/console/

docs/detections/ vs docs/security/detections/

docs/detections/ is the current detection-rule catalogue with machine-parseable YAML/JSON fixtures. docs/security/detections/ contains a single narrative memo. These are complementary, not duplicates, but the naming overlap causes confusion.

docs/dev/

docs/groomer/ + docs/grooming/ + docs/ops/grooming/

Three directories for the same category of content (agent grooming pass logs). Category: duplicate.

docs/incidents/ vs docs/ops/incidents/

Two incident log directories. Category: duplicate.

docs/runbooks/ vs docs/ops/runbooks/ vs docs/security/runbooks/

Three runbook directories. docs/ops/runbooks/ is the canonical home (has the README.md and rotation/ subdir). The other two are satellites that predate the canonical location. Category: duplicate.

docs/sprint/ + docs/sprint-plans/ + docs/sprints/

Three directories holding sprint planning documents. Category: duplicate.

docs/ux/ vs docs/ux-mockups/ vs docs/design/

docs/design/ is the ux-polisher output directory with full mockup sets. docs/ux/ contains newer deliverables (beta flows, cookie consent, options-chain redesign, market-time-widget). docs/ux-mockups/ has only 4 image files from PR #2692. Category: duplicate (ux-mockups); current (both design/ and ux/ serve active work, but the split is confusing).

docs/morning-brief/

Single file 2026-06-02.md. Other morning briefs likely land in memory system, not files. Category: unknown / personal-scratch.

3. Duplicate file pairs (by name + overlapping content)

4. Dead links (internal cross-references to missing files)

5. Orphan files (not referenced from any other doc or code)

The following have no inbound links found in a basic cross-reference pass. They are candidates for personal-scratch or archive review:

• docs/claude_research_prompt.md
• docs/SUMMARY.md
• docs/demo/demo-frontend-only-2026-05-13.md
• docs/decisions/ — single file, not referenced
• docs/morning-brief/2026-06-02.md
• docs/sprint/dispatch-plan-2026-05-19-morning-wave-2.md
• docs/sprint-plans/sprint-2026-05-21-launch-window.md
• docs/blr/internal-docs-hostname-2026-04-29.md
• docs/business/memory/project_sentiment_roadmap_shape123.md
• docs/groomer/ (both files)
• docs/grooming/2026-04-22-backlog-pass.md

6. MUST-REDACT flags

No operator home address found in docs/. The LLC formation record at docs/business-legal/llc-formation/2026-05-13-northwest-order-record.md correctly uses the Northwest Registered Agent address and explicitly notes the operator's home address is NOT recorded. No action needed on address grounds.

The operator email kris@moosequest.net appears in docs/security/web-surface-posture.md as a CF Access allowlist entry. This is an internal-only doc behind CF Access, so the exposure is acceptable — but it should be reviewed if the doc is ever promoted to a public surface.