docs: seed strategic docs into platform/docs root #5

Merged

pappi merged 1 commit from agent/seed-strategic-docs into main

2026-05-09 16:08:20 +00:00

pappi commented

2026-05-09 16:07:36 +00:00

Owner

What

Seeds the 12 strategic docs produced over the 2026-05-09 chat
session into platform/docs/ as the canonical "current" set:

At platform/docs/ root (8 files):

operating-thesis.md
strategy.md — consolidates strategy.md + strategy-v1.md; v1
fully folded in (numbered customer-journey list, geographic Y1-5
plan, IoT progression detail, three-layer data-model elaboration,
pipeline cost framing, indie-vs-enterprise failure-mode
warning); no version-numbered filename retained.
decisions-log.md — consolidates decisions-log.md +
decisions-log-v1.md; v1 was a strict subset of v2 (D-001 through
D-030 verbatim identical; v2 extends with D-031 through D-040).
technical-architecture.md
architecture-summary.md
partnership-and-channel-map.md
next-90-days-execution-plan.md
recalibration-log.md

At platform/docs/architecture/components/ (4 files):

shared.md, sahaaya.md, realmetre.md, control-plane.md

Why

These docs are the source-of-truth strategic + architectural
material for the platform going forward. They were produced over an
extended chat session today; until now they've sat in the operator
working tree untracked. Landing them on main:

Makes them version-controlled and reviewable.
Establishes them as the preserve-as-is anchors for the
upcoming doc-trueup pass — the trueup's cluster-rules.json
declares these exact paths as preserve-as-is so they don't get
re-aggregated.
Eliminates the v1↔canonical version pairs (per direction:
"aggregate and rewrite, don't use version numbers in names").

How verified

Conforms to B3 git policy: branch agent/seed-strategic-docs
matches the regex; commit follows Conventional Commits
(docs: seed strategic docs into platform/docs root); this PR
body has the three required sections.
Version-pair consolidations follow the rules in
temp/prompts/aggregate-version-pair.txt — latest as
structural backbone, earlier preserved where it adds substance,
contradictions flagged inline (none found in either pair).
Subagent that performed the consolidation reported no v1
content was dropped that wasn't either preserved verbatim or
integrated phrasings; subagent flagged a few areas
(Section 3 numbered-list step 5 in strategy, Section 5
customer-evolution duplication) as worth a human eyeball
during review.

Refs: B3 (platform/docs/wip/B3-git-policy.md),
temp/prompts/aggregate-version-pair.txt,
temp/rules/cluster-rules.json (preserve_as_is_paths).

## What Seeds the 12 strategic docs produced over the 2026-05-09 chat session into `platform/docs/` as the canonical "current" set: **At platform/docs/ root (8 files):** - `operating-thesis.md` - `strategy.md` — consolidates `strategy.md` + `strategy-v1.md`; v1 fully folded in (numbered customer-journey list, geographic Y1-5 plan, IoT progression detail, three-layer data-model elaboration, pipeline cost framing, indie-vs-enterprise failure-mode warning); no version-numbered filename retained. - `decisions-log.md` — consolidates `decisions-log.md` + `decisions-log-v1.md`; v1 was a strict subset of v2 (D-001 through D-030 verbatim identical; v2 extends with D-031 through D-040). - `technical-architecture.md` - `architecture-summary.md` - `partnership-and-channel-map.md` - `next-90-days-execution-plan.md` - `recalibration-log.md` **At platform/docs/architecture/components/ (4 files):** - `shared.md`, `sahaaya.md`, `realmetre.md`, `control-plane.md` ## Why These docs are the source-of-truth strategic + architectural material for the platform going forward. They were produced over an extended chat session today; until now they've sat in the operator working tree untracked. Landing them on `main`: 1. Makes them version-controlled and reviewable. 2. Establishes them as the **preserve-as-is anchors** for the upcoming doc-trueup pass — the trueup's `cluster-rules.json` declares these exact paths as preserve-as-is so they don't get re-aggregated. 3. Eliminates the v1↔canonical version pairs (per direction: "aggregate and rewrite, don't use version numbers in names"). ## How verified - Conforms to B3 git policy: branch `agent/seed-strategic-docs` matches the regex; commit follows Conventional Commits (`docs: seed strategic docs into platform/docs root`); this PR body has the three required sections. - Version-pair consolidations follow the rules in `temp/prompts/aggregate-version-pair.txt` — latest as structural backbone, earlier preserved where it adds substance, contradictions flagged inline (none found in either pair). - Subagent that performed the consolidation reported no v1 content was dropped that wasn't either preserved verbatim or integrated phrasings; subagent flagged a few areas (Section 3 numbered-list step 5 in strategy, Section 5 customer-evolution duplication) as worth a human eyeball during review. --- Refs: B3 (`platform/docs/wip/B3-git-policy.md`), temp/prompts/aggregate-version-pair.txt, temp/rules/cluster-rules.json (preserve_as_is_paths).

pappi added 1 commit

2026-05-09 16:07:36 +00:00

docs: seed strategic docs into platform/docs root

Branch policy / branch-policy (pull_request) Successful in 22s

Details

dd37b9053c

Adds the strategic docs produced over the 2026-05-09 chat session as
the canonical 'current' set under platform/docs/. They become the
preserve-as-is anchors for the upcoming doc-trueup pass.

Files added (12):
- platform/docs/operating-thesis.md
- platform/docs/strategy.md (consolidates strategy.md + strategy-v1.md;
  v1 fully folded in, no version-numbered filename retained)
- platform/docs/decisions-log.md (consolidates decisions-log.md +
  decisions-log-v1.md; v1 was a strict subset of v2)
- platform/docs/technical-architecture.md
- platform/docs/architecture-summary.md
- platform/docs/partnership-and-channel-map.md
- platform/docs/next-90-days-execution-plan.md
- platform/docs/recalibration-log.md
- platform/docs/architecture/components/{shared,sahaaya,realmetre,control-plane}.md

The version-pair consolidations follow the rules in
temp/prompts/aggregate-version-pair.txt (latest as structural backbone;
older preserved where it elaborates; contradictions flagged inline,
none found here).