Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.
JavaScript agentic-codingai-agentsai-governanceautonomous-agentsclaude-codeclicode-reviewcodexcoding-agentsdeveloper-toolsgit-hooksllmlocal-firstmulti-agentsoftware-factoryspec-driven-developmentverificationvibe-coding
docs: tracked files never quote the owner or name machines
Corey Olson69beea78ddb3
diff --git a/DOCTRINE.md b/DOCTRINE.mdindex 4df970dc..08ba6dbb 100644--- a/DOCTRINE.md+++ b/DOCTRINE.md@@ -9,6 +9,7 @@ Statuses: approved = in force · draft = proposed · wont = considered and decli- W2 [approved, must] Headers: type(scope): subject [ids], 72 characters, no emojis. A body only for a non-obvious why, three sentences at most. | gate: commit-msg hook, review- W3 [approved, must] Spec ids go in commits, code headers and test names, never in words meant for people. | gate: review- W4 [approved, must] A refusal names its rule as a code and says the next step. | gate: review+- W5 [draft, must] Tracked files and commit bodies never quote the owner or report what they said, chose or wanted, and never name private infrastructure: machine names, hostnames, LAN addresses or home paths. A commit is a subject line, then at most `Pullboard-Item: #N`. | gate: review## C · Code- C1 [approved, must] Plain JavaScript ES modules; no build step. | gate: package testdiff --git a/docs/demo/index.html b/docs/demo/index.htmlindex 19ab4bb2..de5b4627 100644--- a/docs/demo/index.html+++ b/docs/demo/index.html@@ -2508,7 +2508,7 @@ function readMilestone(milestone, p) {const numeric = value => Number.isInteger(value) && value >= 0 ? value : null;const done = numeric(milestone.summary?.landed) ?? numeric(milestone.landed) ?? verified.length;const total = numeric(milestone.summary?.total) ?? numeric(milestone.total) ?? rows.length;- // Nothing left (every item landed or withdrawn) is finished and sits under Shipped, shipped or not (the person, 18 Oct).+ // Nothing left (every item landed or withdrawn) is finished and sits under Shipped, shipped or not.const left = numeric(milestone.summary?.left), finished = milestone.items.length > 0 && (left !== null ? left === 0 : rows.every((row) => row.stage === 'merged'));const shipped = finished || (milestone.shipped !== undefined ? Boolean(milestone.shipped) : rows.length > 0 && verified.length === rows.length);return { milestone, rows, done, total, shipped };diff --git a/docs/privacy.test.js b/docs/privacy.test.jsnew file mode 100644index 00000000..58a39bcc--- /dev/null+++ b/docs/privacy.test.js@@ -0,0 +1,18 @@+/** Tracked docs never quote the project owner or name private machines, and the rule stays a draft row [W5]. */+import assert from 'node:assert/strict';+import { execFileSync } from 'node:child_process';+import { readFileSync } from 'node:fs';+import { join } from 'node:path';+import { test } from 'node:test';++test('[W5] tracked docs never quote the owner or name private machines, and the rule is a draft row', () => {+ const root = join(import.meta.dirname, '..');+ const tracked = execFileSync('git', ['ls-files', 'docs', 'DOCTRINE.md', 'README.md', 'CONTRIBUTING.md', 'CHANGELOG.md'], { cwd: root, encoding: 'utf8' })+ .trim().split('\n').filter((name) => name !== 'docs/privacy.test.js' && /\.(?:md|html|mjs|js|css|svg|json)$/u.test(name));+ // This file holds the pattern itself, so it is the one tracked file the scan leaves out.+ const attribution = /\b(?:the|The) person, \d{1,2} [A-Z][a-z]{2}\b|\b(?:Studio|MacBook|MBP)\b/u;+ const quoted = tracked.filter((name) => attribution.test(readFileSync(join(root, name), 'utf8')));+ assert.deepEqual(quoted, [], `tracked docs quote the owner or name a machine: ${quoted.join(', ')}`);+ const doctrine = readFileSync(join(root, 'DOCTRINE.md'), 'utf8');+ assert.match(doctrine, /^- W5 \[draft, must\] Tracked files and commit bodies never quote the owner/mu, 'the privacy rule is a draft row awaiting the person');+});