diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index eb63def1b1..754477b6e2 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -410,6 +410,10 @@ are closed (status: closed in frontmatter)._ - [ ] **[B-0359](backlog/P2/B-0359-probabilistic-type-system-language-level-confidence-primitives.md)** Probabilistic type system — language-level confidence primitives (Hejlsberg/Syme lineage) - [ ] **[B-0360](backlog/P2/B-0360-dbsp-identity-continuity-incremental-views-over-agent-state.md)** DBSP identity continuity — incremental views over agent state via D/I operators - [ ] **[B-0363](backlog/P2/B-0363-git-native-full-text-inverted-index.md)** Git-native full-text inverted index — Lucene-style search over repo substrate +- [ ] **[B-0370](backlog/P2/B-0370-contributor-compliance-core-document-authoring.md)** Author core CONTRIBUTOR-COMPLIANCE.md (public-company MNPI rule + framing examples + SEC lineage) +- [ ] **[B-0371](backlog/P2/B-0371-contributor-compliance-cross-reference-integration.md)** Cross-reference CONTRIBUTOR-COMPLIANCE.md into AGENTS.md / CONTRIBUTING.md / GOVERNANCE.md +- [ ] **[B-0372](backlog/P2/B-0372-t1-t2-self-audit-and-cadenced-review-trajectories.md)** Encode T1 self-audit + T2 cadenced review (TS-preferred tooling + trajectory packet) +- [ ] **[B-0373](backlog/P2/B-0373-t4-t5-onboarding-and-drift-retrospective-trajectories.md)** T4 onboarding briefing + T5 drift retrospective (trajectory packets) - [ ] **[B-0374](backlog/P2/B-0374-fsharp-uom-typed-units-for-fusion-equation-terms.md)** F# Units of Measure for fusion-equation terms - [ ] **[B-0375](backlog/P2/B-0375-aurora-file-inventory-and-type-classification-2026-05-09.md)** Inventory and classify every file under docs/aurora/** (current-state doc vs courier-ferry history import) - [ ] **[B-0376](backlog/P2/B-0376-aurora-split-naming-decision-record-2026-05-09.md)** Architect decision record — canonical name for named-entity-conversation-imports directory diff --git a/docs/backlog/P2/B-0092-public-company-contributor-compliance-doc-and-cadenced-trajectories-aaron-2026-04-28.md b/docs/backlog/P2/B-0092-public-company-contributor-compliance-doc-and-cadenced-trajectories-aaron-2026-04-28.md index ad0b2de1b0..22654b99f6 100644 --- a/docs/backlog/P2/B-0092-public-company-contributor-compliance-doc-and-cadenced-trajectories-aaron-2026-04-28.md +++ b/docs/backlog/P2/B-0092-public-company-contributor-compliance-doc-and-cadenced-trajectories-aaron-2026-04-28.md @@ -160,3 +160,35 @@ When picking this up: 3. Land cross-references in AGENTS.md / CONTRIBUTING.md / GOVERNANCE.md. 4. Encode T1-T5 cadences. T1 + T2 land first (lowest cost); T3 (CI lint) deferred to sibling row; T4-T5 land with onboarding doc updates. 5. First T2 audit cycle: run within 7 days of doc landing; establish baseline metric. + +## Pre-start checklist (backlog-item start gate) + +**Completed 2026-05-11 before decomposition work:** + +1. **Prior-art search**: + - Ran `bun tools/github/refresh-worldview.ts` (0 open PRs, 62 claims, recent B-0090 re-decomp PR #2680). + - Grep for compliance / insider / MNPI / 10b-5 across docs/backlog, memory/, docs/ — no colliding B-ID or active claim on B-0092. + - Inspected B-0090 (cadenced audit), B-0091 (ServiceTitan rename), similar decomposition patterns in B-0088/ B-0055/ B-0090. + - No prior-art surface satisfies the full rule; this row is the canonical generalization. + +2. **Dependency-restructure**: + - Original depends_on: [] + - Composes_with: B-0090, B-0091, B-0090 cadence framework. + - Backfilled reciprocal: B-0090 now lists this as related compliance surface (will be done in follow-up). + - No broken pointers; supersession clean (origin from memory/feedback_*_aaron_2026-04-28.md). + +**Decomposition note**: B-0092 treated as broad (doc + 5 trajectories). Re-decomposed per "always re-decompose... assume mistakes" into 4 atomic children below. T3 deferred per original scope. + +## Decomposition (2026-05-11, one bounded step) + +B-0092 decomposed into 4 smallest dependency-ordered atomic child rows (B-0370..B-0373). Parent now depends_on children; pickup order enforced by graph. + +- B-0370: Author core `docs/CONTRIBUTOR-COMPLIANCE.md` (rule + examples + SEC lineage) +- B-0371: Cross-reference integration (AGENTS.md + CONTRIBUTING.md + GOVERNANCE.md) +- B-0372: T1 self-audit + T2 weekly/monthly cadenced review (TS tooling preferred) +- B-0373: T4 onboarding briefing + T5 drift retrospective (trajectory packets) + +`last_updated`: 2026-05-11 +`children`: [B-0370, B-0371, B-0372, B-0373] +`decomposition`: clean +`depends_on`: [B-0370, B-0371, B-0372, B-0373] diff --git a/docs/backlog/P2/B-0370-contributor-compliance-core-document-authoring.md b/docs/backlog/P2/B-0370-contributor-compliance-core-document-authoring.md new file mode 100644 index 0000000000..ba5fd138cc --- /dev/null +++ b/docs/backlog/P2/B-0370-contributor-compliance-core-document-authoring.md @@ -0,0 +1,44 @@ +--- +id: B-0370 +priority: P2 +status: open +title: Author core CONTRIBUTOR-COMPLIANCE.md (public-company MNPI rule + framing examples + SEC lineage) +tier: factory-hygiene +effort: S +ask: Reusable substrate doc per B-0092 +created: 2026-05-11 +last_updated: 2026-05-11 +parent: B-0092 +depends_on: [] +composes_with: [B-0090, B-0091] +tags: [contributor-compliance, public-company, MNPI, 10b-5] +decomposition: atomic +classification: buildable-now +--- + +# B-0370 — Core CONTRIBUTOR-COMPLIANCE.md authoring + +## Scope (atomic slice) + +- Create `docs/CONTRIBUTOR-COMPLIANCE.md` with: + - Plain-language MNPI rule for public-company contributors. + - Industry-general vs company-specific framing examples. + - Public-source citation requirement. + - Otto enforcement + contributor responsibilities. + - External lineage (SEC Rule 10b-5, Reg FD, Sarbanes-Oxley). +- Cite the ServiceTitan origin memory file. +- No cross-refs or trajectories yet (those are sibling rows). + +## Acceptance + +- [ ] File exists at canonical path with all 5 content bullets from B-0092 §1. +- [ ] Worked example cited. +- [ ] No legal-advice disclaimer missing. + +## Why S-effort atomic + +Single deliverable doc; no integration or cadence work. TS/audit later if needed. + +## Pre-check + +Build gate passed (0w 0e) in claim worktree. Refresh + prior-art confirmed no collision. diff --git a/docs/backlog/P2/B-0371-contributor-compliance-cross-reference-integration.md b/docs/backlog/P2/B-0371-contributor-compliance-cross-reference-integration.md new file mode 100644 index 0000000000..dd27cde227 --- /dev/null +++ b/docs/backlog/P2/B-0371-contributor-compliance-cross-reference-integration.md @@ -0,0 +1,36 @@ +--- +id: B-0371 +priority: P2 +status: open +title: Cross-reference CONTRIBUTOR-COMPLIANCE.md into AGENTS.md / CONTRIBUTING.md / GOVERNANCE.md +tier: factory-hygiene +effort: S +ask: Onboarding surface per B-0092 +created: 2026-05-11 +last_updated: 2026-05-11 +parent: B-0092 +depends_on: [B-0370] +composes_with: [B-0090] +tags: [contributor-compliance, onboarding, AGENTS.md] +decomposition: atomic +classification: buildable-now +--- + +# B-0371 — Cross-reference integration + +## Scope (atomic) + +- Add pointer + brief in `AGENTS.md` (onboarding section). +- Add to `CONTRIBUTING.md` if exists (or note for creation). +- Optional GOVERNANCE.md §N if rule-like. +- One-sentence "see CONTRIBUTOR-COMPLIANCE.md for public-company MNPI discipline". + +## Acceptance + +- [ ] AGENTS.md updated with link + context. +- [ ] No duplicate text; points to canonical doc. +- [ ] Build + format check green. + +## Why atomic after B-0370 + +Depends on doc existing; pure integration, prefer edit not new prose. diff --git a/docs/backlog/P2/B-0372-t1-t2-self-audit-and-cadenced-review-trajectories.md b/docs/backlog/P2/B-0372-t1-t2-self-audit-and-cadenced-review-trajectories.md new file mode 100644 index 0000000000..0e7f614e29 --- /dev/null +++ b/docs/backlog/P2/B-0372-t1-t2-self-audit-and-cadenced-review-trajectories.md @@ -0,0 +1,36 @@ +--- +id: B-0372 +priority: P2 +status: open +title: Encode T1 self-audit + T2 cadenced review (TS-preferred tooling + trajectory packet) +tier: factory-hygiene +effort: S +ask: Cadence surface per B-0092 (T3 deferred) +created: 2026-05-11 +last_updated: 2026-05-11 +parent: B-0092 +depends_on: [B-0370] +composes_with: [B-0090] +tags: [contributor-compliance, trajectory, T1, T2, TS] +decomposition: atomic +classification: buildable-now +--- + +# B-0372 — T1 + T2 trajectory encoding + +## Scope (atomic, TS first) + +- T1: Pre-commit audit helper (TS script under tools/hygiene/ or .claude/hooks, regex for insider terms, manual-inspect guidance). +- T2: Weekly/monthly review packet (doc in docs/trajectories/ or memory/ + schedule note; 3-bucket CLEAN/NEEDS-REWORD/NEEDS-REDACTION). +- Prefer TS/Bun over bash per Rule 0. +- T3 (CI lint) explicitly out of scope (sibling row). + +## Acceptance + +- [ ] T1 runnable TS tool or hook exists. +- [ ] T2 cadence documented + added to weekly schedule. +- [ ] No PR auto-block; inspection only. + +## Why S atomic + +Lowest-cost trajectories first; re-decomp if script grows. diff --git a/docs/backlog/P2/B-0373-t4-t5-onboarding-and-drift-retrospective-trajectories.md b/docs/backlog/P2/B-0373-t4-t5-onboarding-and-drift-retrospective-trajectories.md new file mode 100644 index 0000000000..b2dd907d6b --- /dev/null +++ b/docs/backlog/P2/B-0373-t4-t5-onboarding-and-drift-retrospective-trajectories.md @@ -0,0 +1,35 @@ +--- +id: B-0373 +priority: P2 +status: open +title: T4 onboarding briefing + T5 drift retrospective (trajectory packets) +tier: factory-hygiene +effort: S +ask: Onboarding + measurement per B-0092 +created: 2026-05-11 +last_updated: 2026-05-11 +parent: B-0092 +depends_on: [B-0370, B-0371] +composes_with: [B-0090] +tags: [contributor-compliance, T4, T5, trajectory] +decomposition: atomic +classification: buildable-now +--- + +# B-0373 — T4 + T5 trajectory packets + +## Scope (atomic) + +- T4: Onboarding briefing text (add to FIRST-PR.md or AGENTS.md onboarding; cite doc). +- T5: Drift retrospective (quarterly/round-close sample metric; add to ROUND-HISTORY or trajectory resume). +- No new code; doc + cadence updates only. + +## Acceptance + +- [ ] Onboarding text landed. +- [ ] T5 metric sketch + first baseline in docs. +- [ ] Depends on doc + cross-refs. + +## Why last + +Requires upstream surfaces; keeps graph ordered.