Skip to content

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.

docs(doctrine): fit PB9 in the 20-word row limit [D1,D3]

Corey Olsonc03f16f7e2d0
diff --git a/docs/rfcs/0005-commit-metadata.md b/docs/rfcs/0005-commit-metadata.md
index 3b34a485..fe0beed3 100644
--- a/docs/rfcs/0005-commit-metadata.md
+++ b/docs/rfcs/0005-commit-metadata.md
@@ -81,6 +81,7 @@ A commit not tied to an item (configuration, chores) carries no Pullboard traile
- A short `docs/commits.md` documents the format above, versioned (not the long `docs/formats.md`).
- The standard doctrine's PB9 gains one sentence: the trailers are generated, and text never follows them.
+ Amended 26 Oct 2026, approved by the person: the extended row broke the 20-word row limit, so PB9 now reads "Headers: type(scope): subject [ids], ≤72 characters. Body only for a non-obvious why, three sentences at most. Generated trailers come last."
- `Pullboard-Companion` is retired: a change another lane needs is a child item (#1221) with its own `Pullboard-Item`. Existing commits keep it; readers treat it as `Pullboard-Item`.
- Applies from the release that ships it. History is not rewritten.
diff --git a/src/standard-doctrine.md b/src/standard-doctrine.md
index 7e6b5cb3..a203f525 100644
--- a/src/standard-doctrine.md
+++ b/src/standard-doctrine.md
@@ -11,7 +11,7 @@ Version: 1
- PB6 [approved, must] Tests pass before a change merges. | gate: the project's gate
- PB7 [pending, aim] Tests touch nothing outside a temporary sandbox. | gate: review
- PB8 [approved, must] No secrets or sensitive info in the repo; test data is synthetic. | gate: review
-- PB9 [approved, must] Headers: type(scope): subject [ids], 72 characters at most. A body only for a non-obvious why, three sentences at most. Pullboard trailers are generated, and no text follows the final trailer paragraph. | gate: commit-msg hook, review
+- PB9 [approved, must] Headers: type(scope): subject [ids], ≤72 characters. Body only for a non-obvious why, three sentences at most. Generated trailers come last. | gate: commit-msg hook, review
- PB10 [approved, must] Comments explain why, not what; no commented-out code. | gate: review
- PB11 [approved, must] A new dependency states why it is needed and what it pulls in. | gate: review
- PB12 [approved, must] Questions go on the board, one step up the chain, and the asker keeps working on what it can meanwhile. | gate: review
diff --git a/test/doctrine.test.js b/test/doctrine.test.js
index 4dc7a2fc..08582b1c 100644
--- a/test/doctrine.test.js
+++ b/test/doctrine.test.js
@@ -10,10 +10,8 @@ import { doctrineText, loadDoctrine, standardDoctrine, STANDARD_VERSION } from '
import { lintSpec, parseSpec } from '../src/spec.js';
import { renderSpecView } from '../src/view.js';
-const PB9_TRAILER_SENTENCE = ' Pullboard trailers are generated, and no text follows the final trailer paragraph.';
-// RFC 0005 deliberately extends PB9; retain the linter's exact warning, not a blanket exemption.
-const PB9_LENGTH_WARNING = { level: 'warning', line: 14, id: 'PB9',
- message: '31 words; rows stay under 20, the why goes elsewhere' };
+// RFC 0005 extends PB9; its 26 Oct amendment is the approved 20-word text, so the row lints clean.
+const PB9_TEXT = 'Headers: type(scope): subject [ids], ≤72 characters. Body only for a non-obvious why, three sentences at most. Generated trailers come last.';
/** A private repo's configured practice file, automatically removed after its test. */
function practiceBox(t, text, name = 'PRACTICE.md') {
@@ -29,7 +27,7 @@ test('standard version1 retains twelve rules with the approved PB9 trailer amend
/** Comparable rule fields; the packaged file legitimately has different source lines. */
const fields = ({ id, status, tier, text, gate, serves }) => ({ id, status, tier, text, gate, serves });
const expected = rfc.rows.filter((row) => /^PB\d/.test(row.id))
- .map(row => row.id === 'PB9' ? { ...row, text: row.text + PB9_TRAILER_SENTENCE } : row);
+ .map(row => row.id === 'PB9' ? { ...row, text: PB9_TEXT } : row);
assert.deepEqual(standard.rows.map(fields), expected.map(fields));
assert.equal(standard.rows.length, 12);
assert.equal(STANDARD_VERSION, 1);
@@ -38,7 +36,7 @@ test('standard version1 retains twelve rules with the approved PB9 trailer amend
const merged = loadDoctrine(box.root, box.config);
assert.equal(merged.repoExists, false);
assert.deepEqual(merged.rows, standard.rows);
- assert.deepEqual(lintSpec(merged), [PB9_LENGTH_WARNING]);
+ assert.deepEqual(lintSpec(merged), []);
assert.ok(merged.rows.every((row) => row.origin === 'standard' && row.version === 1));
});
@@ -46,7 +44,7 @@ test('repo rules override and decline inherited rows with a reason, keeping sour
const text = '# Local rules\n\n## Team\n- PB2 [approved, must] Deletion needs two approvals. | gate: review\n- PB8 [wont] No persistent data is stored.\n- R1 [fact] An existing local rule.\n';
const box = practiceBox(t, text, 'ways.md');
const merged = loadDoctrine(box.root, box.config);
- assert.deepEqual(lintSpec(merged), [PB9_LENGTH_WARNING]);
+ assert.deepEqual(lintSpec(merged), []);
assert.equal(merged.rows.length, 13);
const own = merged.rows.filter((row) => row.origin === 'repo');
assert.deepEqual(own.map((row) => row.id), ['PB2', 'PB8', 'R1']);