docs(agents): align websources with the shared cross-repo conventions #20

Merged

clawdie merged 1 commit from docs/cross-repo-conventions-pointer into main

2026-10-08 17:39:04 +02:00

clawdie commented

2026-10-08 17:33:43 +02:00

Owner

Addresses #1. Most of the finding was already resolved — this closes the real
remainder.

Already resolved on main (verified, no change needed)

[REMOTE-FORM] — §4 already uses the canonical
ssh://git@code.clawdie.si:2222/clawdie/websources.git.
Jev tooling drift — scripts/jev-classify.py already loads the shared
jev_eval (TypeSafe-first with fallback) via JEV_TRIAGE_ROOT/PATH, passes
caller_attribution, and records provider / provider_attempts / usage /
cost. The Vercel-hardcoded transport is gone.
Ownership decision — the scanner now carries
DOCUMENTATION_REPOS = ("websources",), i.e. the recommended satellite
role, and §1 already says websources must link to component sources rather
than duplicate their contracts.
python3 colibri/scripts/cross-repo-consistency.py → 0 findings across 6
repos.

Fixed here

okf schema drift (§6): named classified_by/status, which the shared
gate does not use and this file's own frontmatter does not carry. Now names
source_of_truth / last_verified (30-day window) / verified_by, plus
platform_notes where the source touches platform-specific code.
Commit identity + branch workflow (§4): now stated, with the explicit note
that the local never push without explicit instruction rule is stricter
than the shared main-is-merge-only workflow and wins here.
Local-rules-win clause: added beside the canonical coordination link, so a
divergence is reconciled canonically instead of silently copied.
Stale build telemetry: the documented page counts said 75 (agents 36,
wiki 8); a real build produces 98 (agents 57, wiki 10). Corrected, and
reworded so the total reads as a smoke signal rather than a contract.

Verification

npm run check:all ✅ (boundaries, links, portal, wiki tests, preview) ·
npm run build ✅ (5 workspaces, 98 pages) · okf freshness bumped to
08.oct.2026.

Not decided here

The sites/docs ↔ component-repo docs/wiki/ overlap is left to §1's existing
rule (link, don't duplicate). Say the word if you want that stated more
explicitly in §3.

Addresses #1. Most of the finding was already resolved — this closes the real remainder. ## Already resolved on main (verified, no change needed) - **`[REMOTE-FORM]`** — §4 already uses the canonical `ssh://git@code.clawdie.si:2222/clawdie/websources.git`. - **Jev tooling drift** — `scripts/jev-classify.py` already loads the shared `jev_eval` (TypeSafe-first with fallback) via `JEV_TRIAGE_ROOT`/`PATH`, passes `caller_attribution`, and records `provider` / `provider_attempts` / `usage` / `cost`. The Vercel-hardcoded transport is gone. - **Ownership decision** — the scanner now carries `DOCUMENTATION_REPOS = ("websources",)`, i.e. the recommended **satellite** role, and §1 already says websources must link to component sources rather than duplicate their contracts. - `python3 colibri/scripts/cross-repo-consistency.py` → **0 findings across 6 repos**. ## Fixed here - **okf schema drift (§6):** named `classified_by`/`status`, which the shared gate does not use and this file's own frontmatter does not carry. Now names `source_of_truth` / `last_verified` (30-day window) / `verified_by`, plus `platform_notes` where the source touches platform-specific code. - **Commit identity + branch workflow (§4):** now stated, with the explicit note that the local *never push without explicit instruction* rule is **stricter** than the shared `main`-is-merge-only workflow and wins here. - **Local-rules-win clause:** added beside the canonical coordination link, so a divergence is reconciled canonically instead of silently copied. - **Stale build telemetry:** the documented page counts said 75 (agents 36, wiki 8); a real build produces **98** (agents 57, wiki 10). Corrected, and reworded so the total reads as a smoke signal rather than a contract. ## Verification `npm run check:all` ✅ (boundaries, links, portal, wiki tests, preview) · `npm run build` ✅ (5 workspaces, 98 pages) · okf freshness bumped to 08.oct.2026. ## Not decided here The `sites/docs` ↔ component-repo `docs/wiki/` overlap is left to §1's existing rule (link, don't duplicate). Say the word if you want that stated more explicitly in §3.

clawdie added 1 commit

2026-10-08 17:33:43 +02:00

docs(agents): align websources with the shared cross-repo conventions dc31b17016

Close the remaining gaps from the cross-repo unification finding:

- §6 named stale okf fields (classified_by/status); the shared gate and
  this file's own frontmatter use verified_by plus platform_notes.
- State the commit identity and branch workflow, and note that the local
  "never push without explicit instruction" rule is stricter than the
  shared one and wins.
- Add the "local rules win; divergence is reconciled canonically" clause
  beside the canonical coordination link.
- Correct the build page counts (75 -> 98: sites/agents 36 -> 57,
  sites/wiki 8 -> 10).

The SCP remote form and the shared Jev tooling drift flagged in the issue
are already resolved on main: §4 uses the canonical ssh://...:2222 form,
scripts/jev-classify.py loads the shared jev_eval and records
caller_attribution/provider, and cross-repo-consistency.py reports zero
findings.

clawdie merged commit 51ace40c2c into main

2026-10-08 17:39:04 +02:00

clawdie deleted branch docs/cross-repo-conventions-pointer

2026-10-08 17:39:04 +02:00

clawdie referenced this pull request from a commit

2026-10-08 17:39:05 +02:00

Merge pull request 'docs(agents): align websources with the shared cross-repo conventions' (#20) from docs/cross-repo-conventions-pointer into main

clawdie referenced this pull request

2026-10-08 18:09:38 +02:00

Cross-repo unification: conventions pointer, remote form, and shared Jev tooling #1