@ngockhoale/ukit 3.5.4 → 3.5.6

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.
Files changed (68) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/manifests/engineConformance.yaml +0 -13
  3. package/manifests/platform.full.yaml +25 -0
  4. package/package.json +3 -9
  5. package/src/cli/commands/indexTools.js +1 -0
  6. package/src/cli/commands/memory.js +44 -4
  7. package/src/core/applyPlan.js +25 -72
  8. package/src/core/diffPlan.js +38 -9
  9. package/src/core/managedTemplateMerge.js +146 -0
  10. package/src/core/memory/memoryCheckRun.js +13 -1
  11. package/src/core/memory/memoryFlags.js +5 -6
  12. package/src/core/memory/memoryHit.js +31 -15
  13. package/src/core/memory/policy.js +5 -0
  14. package/src/core/memory/recallEngine.js +39 -3
  15. package/src/core/memory/recallLanes.js +182 -0
  16. package/src/core/memory/retrieval.js +13 -1
  17. package/src/core/memory/store.js +17 -0
  18. package/src/core/memory/topicCommand.js +75 -0
  19. package/src/core/memory/topicPages.js +545 -0
  20. package/src/core/metadata.js +12 -8
  21. package/src/core/runInstallPipeline.js +16 -10
  22. package/src/core/runtimeConfig.js +59 -83
  23. package/src/core/uninstall.js +8 -1
  24. package/src/decision/registry.js +33 -16
  25. package/src/decision/runtimeDecide.js +5 -5
  26. package/src/index/buildIndex.js +287 -6
  27. package/src/index/languageTools.js +100 -0
  28. package/src/index/paths.js +2 -1
  29. package/src/index/queryIndex.js +174 -10
  30. package/src/index/routeResolver.js +2 -2
  31. package/src/index/semanticLane.js +269 -0
  32. package/src/learning/lessonClass.js +110 -0
  33. package/src/learning/patternProposals.js +111 -7
  34. package/src/learning/reeditMiner.js +104 -0
  35. package/src/learning/selfImprove.js +9 -1
  36. package/template_project/.claude/skills/canvas-design/SKILL.md +2 -2
  37. package/template_project/.claude/skills/canvas-design/canvas-fonts/{InstrumentSans-OFL.txt → InstrumentSerif-OFL.txt} +3 -3
  38. package/template_project/.claude/skills/canvas-design/scripts/fetch-fonts.mjs +148 -0
  39. package/template_project/.claude/ukit/index/embed-index.mjs +26 -0
  40. package/template_project/.claude/ukit/index/lib/index-core.mjs +561 -14
  41. package/template_project/.claude/ukit/index/lib/semantic-lane.mjs +269 -0
  42. package/template_project/.claude/ukit/index/query-index.mjs +9 -1
  43. package/template_project/.claude/ukit/index/refresh-index.mjs +11 -0
  44. package/template_project/.claude/ukit/index/route-resolver.mjs +2 -2
  45. package/template_project/.claude/ukit/runtime/memory-lanes.mjs +9 -2
  46. package/template_project/.claude/ukit/runtime/memory-policy.mjs +5 -0
  47. package/template_project/.claude/ukit/runtime/memory-recall.mjs +39 -3
  48. package/template_project/.claude/ukit/runtime/memory-topics.mjs +545 -0
  49. package/template_project/ukit/storage/config.json +19 -34
  50. package/manifests/instructionRules.yaml +0 -442
  51. package/template_project/.claude/skills/canvas-design/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
  52. package/template_project/.claude/skills/canvas-design/canvas-fonts/BricolageGrotesque-OFL.txt +0 -93
  53. package/template_project/.claude/skills/canvas-design/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
  54. package/template_project/.claude/skills/canvas-design/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
  55. package/template_project/.claude/skills/canvas-design/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
  56. package/template_project/.claude/skills/canvas-design/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
  57. package/template_project/.claude/skills/canvas-design/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
  58. package/template_project/.claude/skills/canvas-design/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
  59. package/template_project/.claude/skills/canvas-design/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
  60. package/template_project/.claude/skills/canvas-design/canvas-fonts/Lora-Bold.ttf +0 -0
  61. package/template_project/.claude/skills/canvas-design/canvas-fonts/Lora-BoldItalic.ttf +0 -0
  62. package/template_project/.claude/skills/canvas-design/canvas-fonts/Lora-Italic.ttf +0 -0
  63. package/template_project/.claude/skills/canvas-design/canvas-fonts/Lora-OFL.txt +0 -93
  64. package/template_project/.claude/skills/canvas-design/canvas-fonts/Lora-Regular.ttf +0 -0
  65. package/template_project/.claude/skills/canvas-design/canvas-fonts/Outfit-Bold.ttf +0 -0
  66. package/template_project/.claude/skills/canvas-design/canvas-fonts/Tektur-Medium.ttf +0 -0
  67. package/template_project/.claude/skills/canvas-design/canvas-fonts/YoungSerif-OFL.txt +0 -93
  68. package/template_project/.claude/skills/canvas-design/canvas-fonts/YoungSerif-Regular.ttf +0 -0
@@ -1,442 +0,0 @@
1
- version: 1
2
- generated: false
3
- description: >-
4
- Canonical rule-ID catalog for the root instruction contracts. Marker comments
5
- <!-- RULE: ID --> tag normative behavior; semantic tests prove delivery.
6
- # marker_in values are drawn from the fixed set of the four marker-bearing
7
- # contract files {template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md}.
8
- # template_project/.omp/RULES.md and .omp/RULES.md are marker-free by SPEC §7.1 policy
9
- # and must never appear here.
10
- # DEVIATION from SPEC §7.2 table: OWN-01 is marker_in: AGENTS set only (not
11
- # SHARED) — its anchor `PROJECT_IMPORTANT.md` does not exist in the CLAUDE
12
- # files, and markers are comment-only (no prose edits allowed). AGENTS-set
13
- # coverage matches the HOST-OC-01/HOST-OWN-01 rows that tag the same overlay.
14
- # paths (optional, DOC-302): list of repo-relative glob strings naming the
15
- # work-tree scope a rule applies to. `**` = any depth, `*` = one segment,
16
- # `?` = one char; `/`-separated, no leading `/`, no `..`, no backslashes.
17
- # Absent = file-scoped only (marker_in governs rendered coverage; paths is
18
- # metadata for future router/doc tooling, consumed by rulesForPath).
19
- rules:
20
- - id: CORE-01
21
- title: One remembered command — ukit install
22
- kind: critical
23
- statement: >-
24
- Human-facing UKit workflow collapses to one remembered command:
25
- `ukit install`; after install, work in natural language inside the
26
- supported harnesses.
27
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
28
- anchor: 'ukit install'
29
- - id: CORE-02
30
- title: Quality first, then speed, then token discipline
31
- kind: supporting
32
- statement: >-
33
- Ordering of priorities for all work: quality first, then speed, then
34
- token discipline.
35
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
36
- - id: CLS-01
37
- title: Trivial lane acts directly
38
- kind: critical
39
- statement: >-
40
- Trivial tasks (typo, label, small rename, spacing, toggle flag, obvious
41
- config change) act directly — no doc reads, planning, index, or agents.
42
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
43
- anchor: 'Act directly'
44
- - id: CLS-02
45
- title: Simple lane pulls smallest useful context
46
- kind: critical
47
- statement: >-
48
- Simple tasks (1-2 files, clear scope, existing pattern) are handled
49
- directly, pulling only the smallest useful context.
50
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
51
- anchor: 'smallest useful context'
52
- - id: CLS-03
53
- title: Non-trivial lane verifies harder
54
- kind: supporting
55
- statement: >-
56
- Non-trivial/risky tasks read deeper, verify harder, and use the
57
- index-first loop then skill activation then targeted verification.
58
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
59
- - id: EXEC-01
60
- title: Continue until write evidence or blocker
61
- kind: critical
62
- statement: >-
63
- For explicit implement/apply/fix requests, continue until the actual edit
64
- is made or a real blocker is found; never stop after read-only steps.
65
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
66
- anchor: 'actual edit is made'
67
- - id: EXEC-02
68
- title: No done-claims without Edit/Write evidence
69
- kind: critical
70
- statement: >-
71
- Completion wording requires concrete Edit/Write evidence in the current
72
- turn, plus verification when the scope is risky.
73
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
74
- anchor: 'concrete Edit/Write evidence'
75
- - id: EXEC-03
76
- title: Routed continuation is not a stopping point
77
- kind: supporting
78
- statement: >-
79
- Routed states like pull-indexed-context or continuation-required are
80
- internal continuation steps; finish the named milestone before widening.
81
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
82
- - id: EXEC-04
83
- title: Every stop names its reason
84
- kind: critical
85
- statement: >-
86
- When a turn ends on a user-only action, open the reply with a
87
- `WAITING ON YOU:` line and schedule a one-shot wakeup when available.
88
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
89
- anchor: 'WAITING ON YOU'
90
- - id: STALL-01
91
- title: Announce waits, verbatim errors, never blame UKit
92
- kind: critical
93
- statement: >-
94
- Long waits must be announced as they happen, any API/tool error surfaced
95
- verbatim in the same turn, and network/API named as the suspect on long
96
- stalls — never blaming UKit.
97
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
98
- anchor: 'never blame UKit'
99
- - id: STALL-02
100
- title: Stall rules extend every-stop-says-why
101
- kind: supporting
102
- statement: >-
103
- The stall/wait reporting rules extend the existing every-stop-names-its-
104
- reason contract (EXEC-04); they do not replace it.
105
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
106
- - id: STALL-03
107
- title: One-tool-call workaround is conditional only
108
- kind: critical
109
- statement: >-
110
- Falling back to one tool call per assistant message is a conditional
111
- workaround that fires only when malformed/concatenated tool-input errors
112
- are observed or the harness version is known-affected — healthy hosts
113
- keep using legitimate parallel calls.
114
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
115
- anchor: 'one tool call per assistant message'
116
- - id: UNATTENDED-01
117
- title: Unattended mode runs the completion loop without a human
118
- kind: critical
119
- statement: >-
120
- Under orchestration.permissionMode: unattended there is no human in the
121
- loop — the loop is UNDERSTAND → PLAN → IMPLEMENT → VERIFY → FIX →
122
- REVERIFY → COMPLETE, and a turn ends only on COMPLETE evidence, a real
123
- external blocker, or a deny decision. Workflow phases do not authorize
124
- changing the user-owned host permission mode: internal PLAN is not host
125
- Plan Mode. Honor managed policy, newer user choices, and parent/subagent
126
- and session boundaries.
127
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
128
- anchor: 'no human in the loop'
129
- - id: UNATTENDED-02
130
- title: Bounded attempts and recovery strategies in unattended mode
131
- kind: supporting
132
- statement: >-
133
- maxAttemptsPerFailure: 2 per failing verification and
134
- maxRecoveryStrategies: 2 distinct fix strategies before reassessing —
135
- do not loop one strategy.
136
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
137
- - id: UNATTENDED-03
138
- title: BLOCKED only on true external blockers
139
- kind: critical
140
- statement: >-
141
- Test failures, lint errors, review findings, and ambiguity are NOT
142
- blockers — they feed FIX; BLOCKED is reserved for missing credentials,
143
- dead services, and unreachable network/API.
144
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
145
- anchor: 'NOT blockers'
146
- - id: UNATTENDED-04
147
- title: A deny becomes the next safer alternative, never a question
148
- kind: critical
149
- statement: >-
150
- A deny (hook/gate/permission) never becomes a question — pick the next
151
- safer alternative that satisfies the intent and record the substitution;
152
- never emit "do you want me to…".
153
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
154
- anchor: 'next safer alternative'
155
- - id: LONG-01
156
- title: LAND one thing, DEFER the rest, DELEGATE broad work
157
- kind: supporting
158
- statement: >-
159
- Near token-cap, land one in-flight item end-to-end, defer the rest into
160
- docs/STATUS.md or bounded handoff tasks, delegate broad work to subagents.
161
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
162
- - id: LONG-02
163
- title: Post-compact continuity from disk state
164
- kind: supporting
165
- statement: >-
166
- After any compact or handoff, continue from persisted disk state without
167
- rereading pre-compact context; delegate and keep replies short.
168
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
169
- - id: IDX-01
170
- title: Check index freshness before code context
171
- kind: critical
172
- statement: >-
173
- For tasks needing code context, check the index is fresh and refresh it
174
- when stale or missing.
175
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
176
- anchor: 'index is fresh'
177
- - id: IDX-02
178
- title: Open top 1-3 suspect files first
179
- kind: critical
180
- statement: >-
181
- Open only the top 1-3 suspect files first, then widen if needed; use the
182
- outline block to jump straight to the relevant region.
183
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
184
- anchor: 'top 1-3 suspect files'
185
- - id: IDX-03
186
- title: Outlines locate code; code to be changed must still be read
187
- kind: critical
188
- statement: >-
189
- The outline locates code but does not describe behaviour; any code about
190
- to be changed must still be read.
191
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
192
- anchor: 'must still be read'
193
- - id: SKILL-01
194
- title: Auto-activate the matching skill
195
- kind: critical
196
- statement: >-
197
- On every non-trivial task, inspect installed project-local skills and
198
- auto-activate the matching skill immediately; end users should not need
199
- to know skill names.
200
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
201
- anchor: 'auto-activate the matching skill'
202
- - id: SKILL-02
203
- title: Smallest effective skill set
204
- kind: supporting
205
- statement: >-
206
- Use the smallest effective set of skills, usually 1-2.
207
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
208
- - id: SKILL-03
209
- title: Upgrade skill choice on sharper evidence
210
- kind: supporting
211
- statement: >-
212
- If evidence becomes more specific than the original prompt, upgrade the
213
- active skill choice immediately.
214
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
215
- - id: HELP-01
216
- title: Prefer internal helper commands for routing/context/verify
217
- kind: supporting
218
- statement: >-
219
- Prefer the index helper scripts (route-task, resolve-context,
220
- verify-context) for routing, related-file context, and verification.
221
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
222
- - id: HELP-02
223
- title: Never ask contributors to run internal helpers
224
- kind: critical
225
- statement: >-
226
- Do not ask normal contributors to run internal helper commands or
227
- memorize maintainer commands; run them yourself or tell them to rerun
228
- `ukit install`.
229
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
230
- anchor: 'Do not ask normal contributors'
231
- - id: OWN-01
232
- title: PROJECT_IMPORTANT.md is the canonical owner-instruction source
233
- kind: critical
234
- statement: >-
235
- Read and follow the root PROJECT_IMPORTANT.md before project work; it is
236
- the canonical project-owner instruction source.
237
- marker_in: [template_project/AGENTS.md, AGENTS.md]
238
- anchor: 'PROJECT_IMPORTANT.md'
239
- - id: SAFE-01
240
- title: Preserve byte-level file details on edit
241
- kind: critical
242
- statement: >-
243
- Preserve UTF-8 BOM/no-BOM and LF/CRLF for existing multilingual or
244
- user-authored files.
245
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
246
- anchor: 'BOM/no-BOM'
247
- - id: SAFE-02
248
- title: Prefer unique current-file anchors for risky edits
249
- kind: critical
250
- statement: >-
251
- For risky/shared/large edits, prefer unique current-file anchors over
252
- line numbers or stale pasted blocks.
253
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
254
- anchor: 'unique current-file anchors'
255
- - id: SAFE-03
256
- title: Ask on missing or ambiguous stale specs
257
- kind: supporting
258
- statement: >-
259
- Do not silently merge stale specs: if old_string is missing or ambiguous,
260
- re-read current source and ask whether to apply, adapt, or skip.
261
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
262
- - id: CTX-01
263
- title: Deterministic segment bytes
264
- kind: critical
265
- statement: >-
266
- Keep prompt-segment bytes deterministic so provider prompt prefixes can
267
- be reused.
268
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
269
- anchor: 'CTX-01'
270
- - id: CTX-02
271
- title: Keep roles and order
272
- kind: critical
273
- statement: >-
274
- Keep message roles and order stable across calls.
275
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
276
- anchor: 'CTX-02'
277
- - id: CTX-03
278
- title: Keep tool IDs and continuation state
279
- kind: critical
280
- statement: >-
281
- Keep tool IDs and continuation state stable for prefix reuse.
282
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
283
- anchor: 'CTX-03'
284
- - id: CTX-04
285
- title: No clock/random IDs in static blocks
286
- kind: critical
287
- statement: >-
288
- Static prompt blocks must not contain clock values or random IDs.
289
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
290
- anchor: 'CTX-04'
291
- - id: CTX-05
292
- title: Compaction starts a new epoch
293
- kind: critical
294
- statement: >-
295
- Compaction starts a new cache epoch; do not expect prefix reuse across it.
296
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
297
- anchor: 'CTX-05'
298
- - id: CTX-06
299
- title: Never change data to match a cache
300
- kind: critical
301
- statement: >-
302
- Never mutate data to make it match a cache entry.
303
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
304
- anchor: 'CTX-06'
305
- - id: CTX-07
306
- title: No unconfirmed cache fields
307
- kind: critical
308
- statement: >-
309
- Do not rely on cache fields that have not been confirmed for the route in
310
- use.
311
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
312
- anchor: 'CTX-07'
313
- - id: CTX-08
314
- title: Tool-result reuse needs valid freshness
315
- kind: critical
316
- statement: >-
317
- Reuse of tool results requires valid freshness.
318
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
319
- anchor: 'CTX-08'
320
- - id: CTX-09
321
- title: Missing usage is unknown, not zero
322
- kind: critical
323
- statement: >-
324
- Missing cache-usage reporting means unknown, not zero savings.
325
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
326
- anchor: 'CTX-09'
327
- - id: CTX-10
328
- title: Never cut a required check to reduce calls
329
- kind: critical
330
- statement: >-
331
- Never skip a required verification or check just to reduce call count.
332
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
333
- anchor: 'CTX-10'
334
- - id: HAND-01
335
- title: Handoff Quality Gate is opt-in via docs/AI_HANDOFF
336
- kind: supporting
337
- statement: >-
338
- The handoff quality gate activates only when a task goes through
339
- docs/AI_HANDOFF; daily prompts keep the old flow.
340
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
341
- paths: [docs/AI_HANDOFF/**]
342
- - id: HAND-02
343
- title: RUN.md is the authoritative handoff run cursor
344
- kind: critical
345
- statement: >-
346
- docs/AI_HANDOFF/RUN.md is the authoritative run cursor; only the
347
- HANDOFF FULLSTACK COMPLETE/BLOCKED markers after Phase done/blocked end
348
- a run.
349
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
350
- anchor: 'RUN.md'
351
- paths: [docs/AI_HANDOFF/**]
352
- - id: HAND-03
353
- title: Handoff planning gates are mechanical and read from disk
354
- kind: supporting
355
- statement: >-
356
- Tasks flip needs_breakdown to ready only on a recorded validator VERDICT ok
357
- plus PLAN_REVIEW Approved; ready-gate.mjs must print READY_GATE ok before
358
- any flip; owner docs persist through source-snapshot.mjs; work lands
359
- through land-worktree.mjs; rewrites need an amendments/rev copy
360
- (amend-guard.mjs) — all bare single node commands.
361
- marker_in: [template_project/AGENTS.md, AGENTS.md]
362
- - id: BUDGET-01
363
- title: Context budget per task class
364
- kind: critical
365
- statement: >-
366
- Context + verification budget rows: Trivial reads no docs, Simple reads
367
- MEMORY only, Non-trivial adds PROJECT and CODE_MAP.
368
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
369
- anchor: '**Trivial**: no docs'
370
- - id: BUDGET-02
371
- title: STATUS.md only for open-ended or continuation prompts
372
- kind: supporting
373
- statement: >-
374
- docs/STATUS.md is used for open-ended status/continue prompts or
375
- meaningful continuation context; stale status is orientation only.
376
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
377
- - id: BUDGET-03
378
- title: WORKLOG recent entries only
379
- kind: supporting
380
- statement: >-
381
- docs/WORKLOG.md is read for recent relevant entries only; archive oldest
382
- entries when over limits.
383
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
384
- - id: STATUS-01
385
- title: STATUS.md is not source truth
386
- kind: supporting
387
- statement: >-
388
- docs/STATUS.md captures compact current state; it is not source truth and
389
- must not replace source/index-first investigation.
390
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
391
- - id: SUBAG-01
392
- title: Delegate only on meaningful context or parallel gains
393
- kind: supporting
394
- statement: >-
395
- Keep direct execution as default for trivial/simple work; delegate only
396
- when it shrinks context or enables useful parallel progress.
397
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
398
- - id: SUBAG-02
399
- title: Small-task maintainer is a sidecar lane
400
- kind: supporting
401
- statement: >-
402
- The ukit-small-task-maintainer subagent handles safe/reversible UKit
403
- chores as a sidecar lane and hands risky work back to the main model.
404
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
405
- - id: AUTO-01
406
- title: autonomy.level controls how much UKit acts without asking
407
- kind: supporting
408
- statement: >-
409
- autonomy.level in .ukit/storage/config.json controls how much UKit acts
410
- without asking first; end users should not need to change it.
411
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
412
- - id: TIER-01
413
- title: Tiers bind through agent definitions
414
- kind: critical
415
- statement: >-
416
- A model tier takes effect only when work is handed to an agent whose own
417
- definition binds that model; the main session model never changes
418
- mid-turn.
419
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
420
- anchor: 'model:'
421
- - id: TIER-02
422
- title: Escalate one tier after repeated failure
423
- kind: supporting
424
- statement: >-
425
- When the same file or symbol fails debugLoopThreshold times in one
426
- session, route the next attempt one tier higher, capped at smart.
427
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
428
- - id: DURA-01
429
- title: DuraOne skill activates only when installed
430
- kind: supporting
431
- statement: >-
432
- The DuraOne skill is active only when the duraone pack is installed or
433
- .claude/skills/duraone/SKILL.md exists; otherwise use generic standards.
434
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
435
- - id: FALLBACK-01
436
- title: Missing/corrupt runtime → rerun ukit install
437
- kind: critical
438
- statement: >-
439
- If the workspace needs a refresh or runtime files are missing or corrupt,
440
- tell maintainers to rerun `ukit install`.
441
- marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
442
- anchor: 'rerun `ukit install`'
@@ -1,93 +0,0 @@
1
- Copyright 2022 The Bricolage Grotesque Project Authors (https://github.com/ateliertriay/bricolage)
2
-
3
- This Font Software is licensed under the SIL Open Font License, Version 1.1.
4
- This license is copied below, and is also available with a FAQ at:
5
- https://openfontlicense.org
6
-
7
-
8
- -----------------------------------------------------------
9
- SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
10
- -----------------------------------------------------------
11
-
12
- PREAMBLE
13
- The goals of the Open Font License (OFL) are to stimulate worldwide
14
- development of collaborative font projects, to support the font creation
15
- efforts of academic and linguistic communities, and to provide a free and
16
- open framework in which fonts may be shared and improved in partnership
17
- with others.
18
-
19
- The OFL allows the licensed fonts to be used, studied, modified and
20
- redistributed freely as long as they are not sold by themselves. The
21
- fonts, including any derivative works, can be bundled, embedded,
22
- redistributed and/or sold with any software provided that any reserved
23
- names are not used by derivative works. The fonts and derivatives,
24
- however, cannot be released under any other type of license. The
25
- requirement for fonts to remain under this license does not apply
26
- to any document created using the fonts or their derivatives.
27
-
28
- DEFINITIONS
29
- "Font Software" refers to the set of files released by the Copyright
30
- Holder(s) under this license and clearly marked as such. This may
31
- include source files, build scripts and documentation.
32
-
33
- "Reserved Font Name" refers to any names specified as such after the
34
- copyright statement(s).
35
-
36
- "Original Version" refers to the collection of Font Software components as
37
- distributed by the Copyright Holder(s).
38
-
39
- "Modified Version" refers to any derivative made by adding to, deleting,
40
- or substituting -- in part or in whole -- any of the components of the
41
- Original Version, by changing formats or by porting the Font Software to a
42
- new environment.
43
-
44
- "Author" refers to any designer, engineer, programmer, technical
45
- writer or other person who contributed to the Font Software.
46
-
47
- PERMISSION & CONDITIONS
48
- Permission is hereby granted, free of charge, to any person obtaining
49
- a copy of the Font Software, to use, study, copy, merge, embed, modify,
50
- redistribute, and sell modified and unmodified copies of the Font
51
- Software, subject to the following conditions:
52
-
53
- 1) Neither the Font Software nor any of its individual components,
54
- in Original or Modified Versions, may be sold by itself.
55
-
56
- 2) Original or Modified Versions of the Font Software may be bundled,
57
- redistributed and/or sold with any software, provided that each copy
58
- contains the above copyright notice and this license. These can be
59
- included either as stand-alone text files, human-readable headers or
60
- in the appropriate machine-readable metadata fields within text or
61
- binary files as long as those fields can be easily viewed by the user.
62
-
63
- 3) No Modified Version of the Font Software may use the Reserved Font
64
- Name(s) unless explicit written permission is granted by the corresponding
65
- Copyright Holder. This restriction only applies to the primary font name as
66
- presented to the users.
67
-
68
- 4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
69
- Software shall not be used to promote, endorse or advertise any
70
- Modified Version, except to acknowledge the contribution(s) of the
71
- Copyright Holder(s) and the Author(s) or with their explicit written
72
- permission.
73
-
74
- 5) The Font Software, modified or unmodified, in part or in whole,
75
- must be distributed entirely under this license, and must not be
76
- distributed under any other license. The requirement for fonts to
77
- remain under this license does not apply to any document created
78
- using the Font Software.
79
-
80
- TERMINATION
81
- This license becomes null and void if any of the above conditions are
82
- not met.
83
-
84
- DISCLAIMER
85
- THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
86
- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
87
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
88
- OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
89
- COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
90
- INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
91
- DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
92
- FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
93
- OTHER DEALINGS IN THE FONT SOFTWARE.
@@ -1,93 +0,0 @@
1
- Copyright 2011 The Lora Project Authors (https://github.com/cyrealtype/Lora-Cyrillic), with Reserved Font Name "Lora".
2
-
3
- This Font Software is licensed under the SIL Open Font License, Version 1.1.
4
- This license is copied below, and is also available with a FAQ at:
5
- https://openfontlicense.org
6
-
7
-
8
- -----------------------------------------------------------
9
- SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
10
- -----------------------------------------------------------
11
-
12
- PREAMBLE
13
- The goals of the Open Font License (OFL) are to stimulate worldwide
14
- development of collaborative font projects, to support the font creation
15
- efforts of academic and linguistic communities, and to provide a free and
16
- open framework in which fonts may be shared and improved in partnership
17
- with others.
18
-
19
- The OFL allows the licensed fonts to be used, studied, modified and
20
- redistributed freely as long as they are not sold by themselves. The
21
- fonts, including any derivative works, can be bundled, embedded,
22
- redistributed and/or sold with any software provided that any reserved
23
- names are not used by derivative works. The fonts and derivatives,
24
- however, cannot be released under any other type of license. The
25
- requirement for fonts to remain under this license does not apply
26
- to any document created using the fonts or their derivatives.
27
-
28
- DEFINITIONS
29
- "Font Software" refers to the set of files released by the Copyright
30
- Holder(s) under this license and clearly marked as such. This may
31
- include source files, build scripts and documentation.
32
-
33
- "Reserved Font Name" refers to any names specified as such after the
34
- copyright statement(s).
35
-
36
- "Original Version" refers to the collection of Font Software components as
37
- distributed by the Copyright Holder(s).
38
-
39
- "Modified Version" refers to any derivative made by adding to, deleting,
40
- or substituting -- in part or in whole -- any of the components of the
41
- Original Version, by changing formats or by porting the Font Software to a
42
- new environment.
43
-
44
- "Author" refers to any designer, engineer, programmer, technical
45
- writer or other person who contributed to the Font Software.
46
-
47
- PERMISSION & CONDITIONS
48
- Permission is hereby granted, free of charge, to any person obtaining
49
- a copy of the Font Software, to use, study, copy, merge, embed, modify,
50
- redistribute, and sell modified and unmodified copies of the Font
51
- Software, subject to the following conditions:
52
-
53
- 1) Neither the Font Software nor any of its individual components,
54
- in Original or Modified Versions, may be sold by itself.
55
-
56
- 2) Original or Modified Versions of the Font Software may be bundled,
57
- redistributed and/or sold with any software, provided that each copy
58
- contains the above copyright notice and this license. These can be
59
- included either as stand-alone text files, human-readable headers or
60
- in the appropriate machine-readable metadata fields within text or
61
- binary files as long as those fields can be easily viewed by the user.
62
-
63
- 3) No Modified Version of the Font Software may use the Reserved Font
64
- Name(s) unless explicit written permission is granted by the corresponding
65
- Copyright Holder. This restriction only applies to the primary font name as
66
- presented to the users.
67
-
68
- 4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
69
- Software shall not be used to promote, endorse or advertise any
70
- Modified Version, except to acknowledge the contribution(s) of the
71
- Copyright Holder(s) and the Author(s) or with their explicit written
72
- permission.
73
-
74
- 5) The Font Software, modified or unmodified, in part or in whole,
75
- must be distributed entirely under this license, and must not be
76
- distributed under any other license. The requirement for fonts to
77
- remain under this license does not apply to any document created
78
- using the Font Software.
79
-
80
- TERMINATION
81
- This license becomes null and void if any of the above conditions are
82
- not met.
83
-
84
- DISCLAIMER
85
- THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
86
- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
87
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
88
- OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
89
- COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
90
- INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
91
- DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
92
- FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
93
- OTHER DEALINGS IN THE FONT SOFTWARE.