Skip to content

docs: satellite-architecture + honest-dogfooding positioning + K1/K2 plan slots (clean rebase) - #191

Merged
artyhoo merged 1 commit into
stagingfrom
docs/sat-arch-positioning-v2
May 24, 2026
Merged

docs: satellite-architecture + honest-dogfooding positioning + K1/K2 plan slots (clean rebase)#191
artyhoo merged 1 commit into
stagingfrom
docs/sat-arch-positioning-v2

Conversation

@artyhoo

@artyhoo artyhoo commented May 24, 2026

Copy link
Copy Markdown
Owner

Summary

Records the project-positioning claim formulated in 2026-05-24 brainstorm: the project is its own first consumer, satellite in a constellation of AI-assistance tools. Four points (single source of truth per artifact; symmetric install; niche occupation with augmentation-not-duplication; companions stay external) + falsifiers + relationship to existing rules.

The patch is additive positioning — does not redefine the project goal (README.md authority stays unchanged) and does not modify behaviour. Two kickoffs (K1 audit, K2 architecture refactor) are proposed via apply-ready diff inside §6 of the patch — NOT applied here (see «Post-merge action» below).

Why clean-rebase replaces PR #190

PR #190 accidentally accumulated a foreign commit 63b5246 (meta-orchestrator audit work from a parallel session) via shared .git/index — normal parallel-worktree dynamic in this project. That commit referenced files not on origin/staging → CI red on broken-ref (principle 14).

Foreign work is preserved on its own branch backup/sat-arch-foreign-meta-orchestrator-audit (HEAD = 63b5246) — author can pick it up there.

This PR re-creates the single research-patch commit cleanly on top of fresh origin/staging (cherry-pick), no contamination. PR #190 will be closed as superseded.

Why one file only

docs/meta-factory/wave-sequencing-plan.md has un-committed foreign edits in working tree (parallel sessions). A clean re-edit by this session would commit those foreign edits alongside ours. The safe path is to record the proposed diff inside the research-patch (§6) and let the maintainer apply it cleanly on their next touch of the plan.

Post-merge action (🟡 maintainer)

When applying the §6 diff to wave-sequencing-plan.md:

# from repo root, after this PR is merged into staging
cat docs/meta-factory/research-patches/2026-05-24-satellite-architecture-and-dogfooding-positioning.md \
  | awk '/^```diff$/,/^```$/' \
  | sed -e '1d' -e '$d' \
  > /tmp/sat-arch-plan.patch
git apply /tmp/sat-arch-plan.patch
# then: review, commit, push

This is not a blocker for merge — the patch itself is the artifact of record; the wave-plan slot table is a downstream operational view.

§1.7 Forward-check applied

Compliance with existing disciplines verified inside the patch (§7 «Forward-check»):

  • no-paid-llm-in-ci.md:1 — patch introduces zero CI-side paid calls; K1 is $0 deterministic; K2 R-phase uses free channels.
  • build-first-reuse-default.md:1 §1/§3 — positioning extends BFR (point 3 augmentation pattern is a specific ADAPT subtype); K2 R-phase explicitly mandates §3 mechanism on «companion-offer at install-time».
  • doc-authority-hierarchy.md:1 §2 — folder-level authority for research-patches/ followed; scope marker <!-- scope:... --> present on line 1 of the new file.
  • reviewer-discipline.md:1 §2 — admission of K1/K2 to wave plan = maintainer call; §6 diff is a proposal, not auto-apply; no role-swap.

§1.7 Backward-check applied

Sweep of artefacts under «satellite-architecture positioning» scope recorded inside the patch (§7 «Backward-check») as a 6-row table. Visible-surface coverage:

Backward-sweep is partial-by-design (full sweep = K1+K2 deliverable). The 6 artefacts above are the visible surface from this session.

Test plan

  • markdownlint pass (pre-commit)
  • principle tests pass (pre-push: 17 files, 110 tests)
  • CI green
  • [maintainer] apply §6 diff to wave-sequencing-plan.md (see «Post-merge action» above)
  • [maintainer-future] K1 audit kickoff written when slot 2.4 admitted
  • [maintainer-future] K2 refactor kickoff written when slot 3.4 admitted

Supersedes #190 (closed). Foreign commit preserved at origin/backup/sat-arch-foreign-meta-orchestrator-audit.

@artyhoo
docs(research-patches): satellite-architecture + honest-dogfooding po…
17c61a3 
…sitioning + K1/K2 plan slots

Records the project-positioning claim formulated in 2026-05-24 brainstorm:
"the project is its own first consumer, satellite in a constellation of
AI-assistance tools." Four points (single source of truth per artifact;
symmetric install; niche occupation with augmentation-not-duplication;
companions stay external), with falsifiers and relationship to existing
rules (extends README invariant #2, refines BFR §1 ADAPT verdict, adjacent
to dual-implementation discipline). Includes apply-ready diff for two
wave-plan slots (K1 audit, K2 architecture refactor) — diff is in §6 of
the patch, not applied here because wave-sequencing-plan.md has un-staged
foreign edits in working tree; maintainer applies the diff cleanly.

§1.7 forward+backward self-check landed inside the patch (§7).
Backward-sweep is partial-by-design (full sweep = K1+K2 deliverable).

Prior-art: skipped — positioning record + plan-slot proposals, no new capability or dependency.
@artyhoo artyhoo mentioned this pull request May 24, 2026
Closed
6 tasks
@artyhoo
artyhoo merged commit e5da05b into staging May 24, 2026
22 checks passed
@artyhoo
artyhoo deleted the docs/sat-arch-positioning-v2 branch May 24, 2026 09:37
This was referenced May 25, 2026
Merged
Closed
artyhoo added a commit that referenced this pull request May 25, 2026
@artyhoo
docs(wave-plan): reconcile §0 to merged-PR reality (Stage 3 UNTRACKED…
9d0a4ed 
… detection) (#220)

Run `bash .claude/skills/meta-orchestrator/helpers/plan-currency-check.sh`
(L2 Stage 3 detection shipped in #217) → 88 UNTRACKED-N entries surfaced
between the 2026-05-22 reconciliation and origin/staging tip (#217). Map
each to an existing §0 / Track row by adding the PR number to its evidence
cell, or to a new §0 row for two umbrellas that landed in full since the
prior snapshot. Re-run helper → 0 UNTRACKED remaining.

Key changes:

- Snapshot date 2026-05-22 → 2026-05-25 (header + §0).
- N8 row: A-phase 🔲 → 🟡 — C1 SSOT-existence (#170), C2 kickoff
  T-enumeration floor (#174), C3 principle 13 §1.7 substance (#178),
  C4 delivery-channel marker (#177), activation #180. C5 + cost-levers
  remain gated on §5.3 utilisation trigger.
- Track M.1 / M.4 → DONE: M.1 codified T20 via #212 (with NB note —
  recommendation-laziness took the T20 slot, mutation-equivalence
  T-bump 20→21 still pending); M.4 6 paired-negative bash-hook tests
  shipped #195/#196/#197/#198/#199/#200.
- Two new §0 rows: Meta-orchestrator skill (Track P) — BUILD #186 +
  audit rounds #192/#193/#194/#201/#202 + UX refactor #203/#204/#205
  + planner-completeness #213/#214/#217 + §1.7 PR-body mandate #216;
  Recommendation-laziness discipline — R-phase #206/#207, benchmark
  #210, I-phase Sub-waves A/C/D #211/#212/#215.
- N7 row: + dogfood research-patch #135 / §4 demotion #166 / live-trial
  verified #171. N4b row: + design #136 / record #118.
- Infra paragraph: PR refs for I.1 follow-ups (#121/#123/#124/#125/
  #128/#130/#131/#143/#145/#146/#147/#148/#149/#172/#187), I.2
  (#139/#142/#154/#175), I.3 DN-4 (#126/#132/#133/#138/#140/#152/
  #159/#161/#162/#167).
- Track 2.3 (channel-earliness audit) → DONE 2026-05-23 (#181); removed
  from "What actually remains".
- Footer subsection: standalone work (#191 satellite-arch / #189
  guard-liveness / #173 storm-readiness / #176 §10 port / #182 cleanup),
  Wave 10 follow-ups (#110/#112/#113), plan-revision history (#108/
  #109/#153/#155/#157/#160/#164/#165/#168/#179/#185).

Verification:
- `bash .claude/skills/meta-orchestrator/helpers/plan-currency-check.sh
  | grep -c '^UNTRACKED'` → 0 (down from 88).
- `npx markdownlint-cli docs/meta-factory/wave-sequencing-plan.md`
  → no violations.
- `npx vitest run packages/core/skills/plan-currency-check.test.ts`
  → 14/14 passed.

Prior-art: skipped — chore, doc reconciliation only, no new capability
or rule introduced.
artyhoo added a commit that referenced this pull request Jul 3, 2026
@artyhoo
feat(diagnostics): D1 diagnostics-core — unified Diagnostic model + a…
4328db4 
…ppend-only FF registry (#862)

Unifies 12 coexisting error models behind one Diagnostic {code, severity, path?, params, message} + an append-only FF registry (packages/core/diagnostics/). Research pipeline gains a zod-style dual API (checkResearchPlan accumulates, validateResearchPlan throws); validateProvenance returns Diagnostic|null; L4 GateFailure gains an additive code field (20 FF3xxx); the two Ajv stacks collapse to one shared factory. Zero behavior change for all current callers; full packages/core suite green (1893 passed).

Also closes an inherited pre-existing staging red: SSOT #195 supplies the Prior-art provenance #861 omitted for agents/backward-sweep-auditor.md (principle 11 F1), under maintainer authorization.

Prior-art: prior-art-evaluations.md#189 (rustc diagnostics, REFERENCE), #190 (tsc diagnosticMessages.json, ADAPT), #191 (SARIF 2.1.0, KEEP NARROW), #192 (zod dual-API, ADOPT VOCABULARY), #193 (Fowler Notification, ADAPT), #194 (ajv shared factory, ADOPT), #195 (backward-sweep-auditor, BUILD).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@artyhoo