@erclx/aitk 0.73.0 → 0.74.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -62,7 +62,7 @@ Two limits worth knowing before you install. Claude Code is the only agent runti
|
|
|
62
62
|
Each domain has a canonical source in this repo and a thin install or sync CLI on your side. The links run to internal narrative, written for someone maintaining the toolkit rather than installing it, so skip them on a first pass.
|
|
63
63
|
|
|
64
64
|
- [Claude Code plugin](.claude/context/claude-plugin/index.md): skills for planning, review, docs sync, and the git ship chain
|
|
65
|
-
- [Governance rules](.claude/context/governance.md):
|
|
65
|
+
- [Governance rules](.claude/context/governance/index.md): Claude rules and stacks, installable per project
|
|
66
66
|
- [Standards](.claude/context/standards/index.md): shared authoring conventions, synced to projects
|
|
67
67
|
- [Snippets](.claude/context/snippets.md): reusable prompts for Claude and Gemini chat
|
|
68
68
|
- [Tooling stacks](.claude/context/tooling.md): golden configs, seeds, and references per framework
|
|
@@ -55,14 +55,16 @@ Every weight and depth measure counts the text a reader is shown. A link reduces
|
|
|
55
55
|
|
|
56
56
|
A code span is walked around rather than through, so a path quoting link or angle-bracket syntax keeps the width the page gives it. Masking inside one takes back the decision to count it, and the placeholders this toolkit writes are where that shows.
|
|
57
57
|
|
|
58
|
-
The paragraph check measures both halves of one rule. `markdown.md` caps a paragraph at four sentences, and a sentence cap on its own is satisfied by writing fewer and longer ones:
|
|
58
|
+
The paragraph check measures both halves of one rule. `markdown.md` caps a paragraph at four sentences, and a sentence cap on its own is satisfied by writing fewer and longer ones: 36 paragraphs in this corpus sit inside four sentences and past the weight checkpoint, and the heaviest of those runs 1121 characters. The standard therefore states a weight beside the sentence cap, and the verb reads it as its own checkpoint.
|
|
59
59
|
|
|
60
|
-
The paragraph weight sits at
|
|
60
|
+
The paragraph weight sits at 700 and the bullet weight at 400. Both shipped at 400, because the paragraph number was borrowed from the bullet rule when the two checks landed together, and each has since been read against a sample of its own. They are separate checkpoints in the standard and separate patterns in the parser, so a read that moves one leaves the other where it is.
|
|
61
61
|
|
|
62
62
|
#### The sample behind the paragraph number
|
|
63
63
|
|
|
64
64
|
The checkpoint shipped at 400 as a borrowed number and was decided against a read of the prose it reports. Thirty-six findings were sampled, six from each of six weight bands, drawn at even spacing through each band ordered by path and line, and each was classed as prose a reader wants split or prose the checkpoint should not have reported.
|
|
65
65
|
|
|
66
|
+
Every band below was measured before the scan stopped counting link syntax as prose, so a paragraph sitting in one of these bands is heavier than a paragraph reported at the same number today. The re-sample in the section below re-reads the same range against the corrected measure and reaches the opposite verdict on it, which is the measure moving rather than the reader.
|
|
67
|
+
|
|
66
68
|
| Band | Wants the split | Reads as written |
|
|
67
69
|
| --------- | --------------- | ---------------- |
|
|
68
70
|
| 400 - 425 | 1 | 5 |
|
|
@@ -78,6 +80,10 @@ Nothing inside the 500 to 600 band separated the two classes by length, which is
|
|
|
78
80
|
|
|
79
81
|
The sample is thirty-six paragraphs against a reported population in the hundreds, and one reader classed all of them. Treat a band's rate as the order of magnitude it is rather than as a measured precision, and re-sample before moving the number again.
|
|
80
82
|
|
|
83
|
+
#### The re-sample that moved the number to 700
|
|
84
|
+
|
|
85
|
+
That re-sample ran once the scan stopped counting link syntax as prose. Findings at 604, 633, and 677 characters each read as an ordinary four-sentence paragraph on one topic, density arrived around 760 and was plain by 860, and the move cut the weight half of the report roughly in half while leaving the sentence cap untouched.
|
|
86
|
+
|
|
81
87
|
A bullet, a heading, a table row, a blockquote, a blank line, and a fence each end a paragraph, so a heavy bullet is reported by the bullet check alone and never counted twice.
|
|
82
88
|
|
|
83
89
|
## Exit codes
|
package/docs/target-projects.md
CHANGED
|
@@ -193,5 +193,5 @@ Sync also refuses a target whose working tree is dirty, so commit or stash befor
|
|
|
193
193
|
|
|
194
194
|
- [agents](agents/index.md): CLI flags, exit codes, and JSON output shapes
|
|
195
195
|
- [AI workflow](ai-workflow.md): feature-development loop inside a toolkit-managed project
|
|
196
|
-
- [tooling](../.claude/context/tooling.md), [governance](../.claude/context/governance.md), [claude plugin](../.claude/context/claude-plugin/index.md), [indexes](../.claude/context/indexes.md), [snippets](../.claude/context/snippets.md), [standards](../.claude/context/standards/index.md): per-domain mechanics
|
|
196
|
+
- [tooling](../.claude/context/tooling.md), [governance](../.claude/context/governance/index.md), [claude plugin](../.claude/context/claude-plugin/index.md), [indexes](../.claude/context/indexes.md), [snippets](../.claude/context/snippets.md), [standards](../.claude/context/standards/index.md): per-domain mechanics
|
|
197
197
|
- [sandbox](../.claude/context/sandbox/index.md): scenario catalog for verifying domain flows
|
package/package.json
CHANGED
package/standards/markdown.md
CHANGED
|
@@ -34,7 +34,7 @@ Does not govern:
|
|
|
34
34
|
|
|
35
35
|
- Use prose by default. Reserve bullets for discrete, unrelated items.
|
|
36
36
|
- Keep paragraphs to four sentences or fewer. Split longer blocks at the next logical boundary.
|
|
37
|
-
- Past roughly
|
|
37
|
+
- Past roughly 700 characters in one paragraph, folding in the lines that wrap it, split at the next logical boundary as well. A paragraph written as two long sentences satisfies the sentence cap above and still asks the reader to hold too much at once. This number sits well above the bullet checkpoint because a paragraph is read straight through and a bullet is scanned.
|
|
38
38
|
- Keep bullets tight. Past roughly 400 characters in one top-level bullet, counting the lines that continue it and excluding any bullet nested under it, the overflow belongs in prose. The number is a checkpoint rather than a cap, and a bullet reading well past it means the number is wrong rather than the rule.
|
|
39
39
|
- Collapse a stack of bullets narrating one subsystem into a single `###` subsection carrying one narrative. Splitting a heavy bullet into three light ones satisfies the checkpoint above and leaves the reader no better off, and subdividing a block does not lighten the bullets inside it, so the two rules answer different defects.
|
|
40
40
|
- Use dashes (`-`) not asterisks (`*`) for bulleted lists
|