Skip to content

chore(norms): rename docs/agents to docs/norms - #70

Merged
Alex1990 merged 1 commit into
mainfrom
loop/69-rename-docs-agents
Sep 21, 2026
Merged

Alex1990 merged 1 commit into
mainfrom
loop/69-rename-docs-agents

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Closes #69

loop-task: #69

Why

Issue #69 asks to move the loop norms directory docs/agents/ to docs/norms/. The title states source and target unambiguously; triage (r-20260920-162608-erpg) inventoried the reference set and classified it feature / ready-for-agent.

What

git mv docs/agents docs/norms (five files: domain.md, issue-tracker.md, ops.md, release.md, triage-labels.md) and every live reference updated:

File Lines
AGENTS.md 7 (docs/agents/ and the five docs/agents/*.md links)
docs/norms/ops.md 64
skills/triage/SKILL.md 18
bump.config.ts 16
scripts/loop/run.mjs 186
scripts/loop/shared/agent.mjs 34, 123
scripts/loop/shared/route.mjs 4
scripts/loop/shared/state.mjs 8 (2 paths)

Diffstat: 12 files changed, 15 insertions(+), 15 deletions(-) — exactly the live occurrences triage found. Relative links inside the moved files (triage-labels.md, release.md, docs/adr/) need no change.

Deliberately not changed

  • CHANGELOG.md:20 mentions docs/agents only as history of commit e3c4cd6; it is changelogen-generated and rewriting it would falsify the record.
  • state/reports/** and state/tasks/** are run history, not repo content.

No source, signer, dependency, test or .github/workflows/** file is touched, so the signer oracles and tree-shaking are unaffected.

Verification

  • pnpm lint — 0 warnings / 0 errors.
  • pnpm fmt:check — all files formatted.
  • pnpm build — exit 0; pnpm check:types — exit 0.
  • pnpm test:ci — Azure and TOS signature oracles all passed; browser suite 24 files passed, 255 passed / 26 skipped.
  • Repo-wide docs/agents search over tracked content after the change — only the historical CHANGELOG.md:20 hit remains.
  • node --check on the four edited .mjs host files — all OK.

Review

Two-lens review (correctness/regression and standards/safety) found no L1/L2 problems. Commit type chore(norms) per AGENTS.md, so this must not appear in CHANGELOG.md. This is a norms-layer change and therefore a proposal PR: the owner's approving review and merge are the checker; the loop does not merge its own work.

Move the loop norms directory to docs/norms and update every live
reference: AGENTS.md, the moved ops.md, skills/triage/SKILL.md,
bump.config.ts and the scripts/loop host strings. CHANGELOG.md and the
state/ run history keep the old path on purpose (falsifying them would
rewrite the record).

Closes #69
@github-actions
github-actions Bot requested a review from Alex1990 as a code owner September 20, 2026 16:31
@github-actions

Copy link
Copy Markdown
Contributor Author

Coverage

Metric % Covered / Total
Lines 91.73% 1121/1222
Statements 90.42% 1209/1337
Functions 92.76% 218/235
Branches 76.97% 575/747

@github-actions

Copy link
Copy Markdown
Contributor Author

Loop pr-review — approve ✅

Independent check of loop/69-rename-docs-agents (head e2f5229), separate from the feature run.

  • Correctness/regression — pure git mv docs/agents docs/norms: 4 renames at 100% similarity and ops.md differing only in its own docs/norms/* line, plus all 15 live references updated (AGENTS.md ×7, docs/norms/ops.md, skills/triage/SKILL.md, bump.config.ts, scripts/loop/run.mjs, scripts/loop/shared/agent.mjs ×2, route.mjs, state.mjs). Repo-wide git grep docs/agents leaves only CHANGELOG.md:20, changelogen history of e3c4cd6 — correctly not rewritten. No source, signer, dependency, test or workflow file touched; no relative link inside the moved files needed changing.
  • Standards/safety — chore(norms) per AGENTS.md (invisible to package consumers, must not reach CHANGELOG.md). The scripts/loop/** edits are host prompt/output strings only, which docs/norms/ops.md explicitly permits as a loop PR. No secrets or dangerous patterns.

Gates re-run from this checkout: pnpm lint 0 warnings/0 errors, pnpm fmt:check clean, pnpm build + pnpm check:types exit 0, Azure + TOS signature oracles passed, browser suite 24 files / 255 passed / 26 skipped with pnpm serve running, and node --check on the four edited .mjs host files OK.

No L1/L2/L3 problems under either lens. As a norms-layer proposal this needs your approving review and merge; the loop does not merge its own work.

@Alex1990
Alex1990 merged commit 7909054 into main Sep 21, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rename docs/agents to docs/norms

1 participant