@veewo/claw-core 0.2.19 → 0.2.20
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 +16 -16
- package/dist/src/embedding-config.d.ts +9 -0
- package/dist/src/embedding-config.js +21 -0
- package/dist/src/embedding-config.js.map +1 -0
- package/dist/src/knowledge-assignments.d.ts +1 -0
- package/dist/src/knowledge-assignments.js +10 -2
- package/dist/src/knowledge-assignments.js.map +1 -1
- package/dist/src/project-config-defaults.d.ts +6 -0
- package/dist/src/project-config-defaults.js +5 -0
- package/dist/src/project-config-defaults.js.map +1 -0
- package/dist/src/resources/cindy-delegate-writer/TEMPLATE.json +1 -1
- package/dist/src/resources/delegate-writer/TEMPLATE.json +1 -1
- package/dist/src/resources/doc-updater/FALLBACK.md +16 -16
- package/dist/src/resources/doc-updater/SKILL.md +19 -19
- package/dist/src/resources/doc-updater/TEMPLATE.json +1 -1
- package/dist/src/resources/knowledge-writer/CONTENT-COVERAGE.md +32 -30
- package/dist/src/resources/knowledge-writer/SKILL.md +6 -6
- package/dist/src/resources/knowledge-writer/TEMPLATE.json +20 -1
- package/dist/src/resources/knowledge-writer/non-claw-fallback.md +53 -53
- package/dist/src/templates/plans/default.js +1 -1
- package/dist/src/workflow-guidance.config.json +365 -365
- package/package.json +48 -48
- package/dist/src/workflow-guidance.codex.config.json +0 -363
- package/dist/src/workflow-guidance.qoder.config.json +0 -362
package/README.md
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# @veewo/claw-core
|
|
2
|
-
|
|
3
|
-
`@veewo/claw-core` is the shared workflow engine behind `claw-kit`.
|
|
4
|
-
|
|
5
|
-
It provides the core primitives that let `.claw` act as a project-level working surface for config resolution, planning, project recall, truth ingestion, and task retention.
|
|
6
|
-
|
|
7
|
-
## Responsibilities
|
|
8
|
-
|
|
9
|
-
- project config normalization and runtime resolution
|
|
10
|
-
- plan lifecycle and workflow guidance primitives
|
|
11
|
-
- project memory and search indexing behavior
|
|
12
|
-
- truth ingestion and retention mechanics
|
|
13
|
-
|
|
14
|
-
## Repository
|
|
15
|
-
|
|
16
|
-
- [claw-kit](https://github.com/chanyuenpang/claw-kit)
|
|
1
|
+
# @veewo/claw-core
|
|
2
|
+
|
|
3
|
+
`@veewo/claw-core` is the shared workflow engine behind `claw-kit`.
|
|
4
|
+
|
|
5
|
+
It provides the core primitives that let `.claw` act as a project-level working surface for config resolution, planning, project recall, truth ingestion, and task retention.
|
|
6
|
+
|
|
7
|
+
## Responsibilities
|
|
8
|
+
|
|
9
|
+
- project config normalization and runtime resolution
|
|
10
|
+
- plan lifecycle and workflow guidance primitives
|
|
11
|
+
- project memory and search indexing behavior
|
|
12
|
+
- truth ingestion and retention mechanics
|
|
13
|
+
|
|
14
|
+
## Repository
|
|
15
|
+
|
|
16
|
+
- [claw-kit](https://github.com/chanyuenpang/claw-kit)
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { MemoryEmbeddingConfig } from "./types.js";
|
|
2
|
+
type VectorStoreConfig = NonNullable<NonNullable<MemoryEmbeddingConfig["store"]>["vector"]>;
|
|
3
|
+
export declare function normalizeVectorStoreConfig(input: {
|
|
4
|
+
enabled?: boolean;
|
|
5
|
+
extensionPath?: string;
|
|
6
|
+
} | null | undefined): {
|
|
7
|
+
vector: VectorStoreConfig;
|
|
8
|
+
} | undefined;
|
|
9
|
+
export {};
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export function normalizeVectorStoreConfig(input) {
|
|
2
|
+
const enabled = input?.enabled;
|
|
3
|
+
const extensionPath = typeof input?.extensionPath === "string" ? input.extensionPath.trim() : "";
|
|
4
|
+
if (enabled === false) {
|
|
5
|
+
return {
|
|
6
|
+
vector: {
|
|
7
|
+
enabled: false,
|
|
8
|
+
...(extensionPath ? { extensionPath } : {}),
|
|
9
|
+
},
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
if (extensionPath) {
|
|
13
|
+
return {
|
|
14
|
+
vector: {
|
|
15
|
+
extensionPath,
|
|
16
|
+
},
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
return undefined;
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=embedding-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"embedding-config.js","sourceRoot":"","sources":["../../src/embedding-config.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,0BAA0B,CAAC,KAGvB;IAClB,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC;IAC/B,MAAM,aAAa,GAAG,OAAO,KAAK,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjG,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO;YACL,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C;SACF,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE;gBACN,aAAa;aACd;SACF,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
|
|
@@ -11,6 +11,7 @@ export function buildKnowledgeDelegateDispatch(input) {
|
|
|
11
11
|
schemaVersion: 1,
|
|
12
12
|
policy: input.policy,
|
|
13
13
|
finalizeId: input.finalizeId,
|
|
14
|
+
preferReuse: true,
|
|
14
15
|
...(input.writer?.model ? { model: input.writer.model } : {}),
|
|
15
16
|
...(input.writer?.reasoningEffort ? { reasoningEffort: input.writer.reasoningEffort } : {}),
|
|
16
17
|
prompt: [
|
|
@@ -32,6 +33,7 @@ export function buildKnowledgeAtomicDispatch(input) {
|
|
|
32
33
|
schemaVersion: 1,
|
|
33
34
|
policy: "subagent",
|
|
34
35
|
finalizeId: input.finalizeId,
|
|
36
|
+
preferReuse: true,
|
|
35
37
|
...(input.writer?.model ? { model: input.writer.model } : {}),
|
|
36
38
|
...(input.writer?.reasoningEffort ? { reasoningEffort: input.writer.reasoningEffort } : {}),
|
|
37
39
|
prompt: [
|
|
@@ -135,8 +137,9 @@ function buildBuiltinKnowledgeTemplate(input) {
|
|
|
135
137
|
const tasks = template.tasks;
|
|
136
138
|
const adrTask = tasks.find((task) => task.id === 5);
|
|
137
139
|
const reviewTask = tasks.find((task) => task.id === 6);
|
|
138
|
-
|
|
139
|
-
|
|
140
|
+
const refreshTask = tasks.find((task) => task.id === 7);
|
|
141
|
+
if (!adrTask || !reviewTask || !refreshTask) {
|
|
142
|
+
throw new Error("Built-in knowledge template is missing the ADR, consistency-review, or index-refresh task.");
|
|
140
143
|
}
|
|
141
144
|
const next = adrTask?.guidance?.onDone?.default;
|
|
142
145
|
if (next) {
|
|
@@ -150,6 +153,11 @@ function buildBuiltinKnowledgeTemplate(input) {
|
|
|
150
153
|
reviewTask.id = 7;
|
|
151
154
|
reviewTask.title = "Run the cross-corpus consistency review";
|
|
152
155
|
reviewTask.detail = `${reviewTask.detail} Include every affected external document in the review and resolve any remaining material contradiction between its current-state claims, current implementation, Truth, and ADR.`;
|
|
156
|
+
const reviewNext = reviewTask.guidance?.onDone?.default;
|
|
157
|
+
if (reviewNext) {
|
|
158
|
+
reviewNext.nextTaskId = 8;
|
|
159
|
+
}
|
|
160
|
+
refreshTask.id = 8;
|
|
153
161
|
tasks.splice(tasks.indexOf(reviewTask), 0, {
|
|
154
162
|
id: 6,
|
|
155
163
|
title: "Update affected external documentation",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"knowledge-assignments.js","sourceRoot":"","sources":["../../src/knowledge-assignments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"knowledge-assignments.js","sourceRoot":"","sources":["../../src/knowledge-assignments.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project-config-defaults.js","sourceRoot":"","sources":["../../src/project-config-defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,MAAM,UAAU,sBAAsB,CAAC,aAInB;IAClB,OAAO,aAAa,EAAE,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC;AAClD,CAAC"}
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# Doc updater fallback
|
|
2
|
-
|
|
3
|
-
Use the supplied finalization evidence and resulting canonical Truth/ADR state
|
|
4
|
-
to update only existing documents inside the frozen external documentation
|
|
5
|
-
paths. Do not create, move, rename, standardize, or otherwise expand the
|
|
6
|
-
external documentation corpus.
|
|
7
|
-
|
|
8
|
-
Inspect candidate documents before editing. Distinguish current-state claims
|
|
9
|
-
from requirements, history, examples, and future design; update only safely
|
|
10
|
-
resolved stale or conflicting current-state claims. Preserve each document's
|
|
11
|
-
language, structure, conventions, and unrelated user edits.
|
|
12
|
-
|
|
13
|
-
Verify the affected corpus with focused and exact identifier searches. It is a
|
|
14
|
-
valid no-edit result when no existing document is affected or an ambiguity
|
|
15
|
-
cannot be resolved safely. Return changed paths or the evidence-backed no-edit
|
|
16
|
-
reason.
|
|
1
|
+
# Doc updater fallback
|
|
2
|
+
|
|
3
|
+
Use the supplied finalization evidence and resulting canonical Truth/ADR state
|
|
4
|
+
to update only existing documents inside the frozen external documentation
|
|
5
|
+
paths. Do not create, move, rename, standardize, or otherwise expand the
|
|
6
|
+
external documentation corpus.
|
|
7
|
+
|
|
8
|
+
Inspect candidate documents before editing. Distinguish current-state claims
|
|
9
|
+
from requirements, history, examples, and future design; update only safely
|
|
10
|
+
resolved stale or conflicting current-state claims. Preserve each document's
|
|
11
|
+
language, structure, conventions, and unrelated user edits.
|
|
12
|
+
|
|
13
|
+
Verify the affected corpus with focused and exact identifier searches. It is a
|
|
14
|
+
valid no-edit result when no existing document is affected or an ambiguity
|
|
15
|
+
cannot be resolved safely. Return changed paths or the evidence-backed no-edit
|
|
16
|
+
reason.
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: doc-updater
|
|
3
|
-
description: Update configured existing external documentation as the dependent documentation stage of knowledge finalization.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Doc updater
|
|
7
|
-
|
|
8
|
-
Resolve `<skill-dir>` as the directory containing this file.
|
|
9
|
-
|
|
10
|
-
Use this skill only when it owns the external-document stage of an active
|
|
11
|
-
knowledge-finalization plan.
|
|
12
|
-
|
|
13
|
-
- When this skill owns the supplied finalization assignment as a stage of an active plan, run `claw subplan create --parent <parent-task-name> --task-id <id> --template-file "<skill-dir>/TEMPLATE.json"`.
|
|
14
|
-
- When explicitly invoked with supplied materials outside an active parent plan, run `claw plan create --template-file "<skill-dir>/TEMPLATE.json" --title "doc-updater"`.
|
|
15
|
-
|
|
16
|
-
The parent stage supplies the frozen external documentation paths, finalization
|
|
17
|
-
materials, and the resulting canonical knowledge state.
|
|
18
|
-
|
|
19
|
-
If the template or claw CLI is unavailable, follow `FALLBACK.md` directly.
|
|
1
|
+
---
|
|
2
|
+
name: doc-updater
|
|
3
|
+
description: Update configured existing external documentation as the dependent documentation stage of knowledge finalization.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Doc updater
|
|
7
|
+
|
|
8
|
+
Resolve `<skill-dir>` as the directory containing this file.
|
|
9
|
+
|
|
10
|
+
Use this skill only when it owns the external-document stage of an active
|
|
11
|
+
knowledge-finalization plan.
|
|
12
|
+
|
|
13
|
+
- When this skill owns the supplied finalization assignment as a stage of an active plan, run `claw subplan create --parent <parent-task-name> --task-id <id> --template-file "<skill-dir>/TEMPLATE.json"`.
|
|
14
|
+
- When explicitly invoked with supplied materials outside an active parent plan, run `claw plan create --template-file "<skill-dir>/TEMPLATE.json" --title "doc-updater"`.
|
|
15
|
+
|
|
16
|
+
The parent stage supplies the frozen external documentation paths, finalization
|
|
17
|
+
materials, and the resulting canonical knowledge state.
|
|
18
|
+
|
|
19
|
+
If the template or claw CLI is unavailable, follow `FALLBACK.md` directly.
|
|
@@ -1,30 +1,32 @@
|
|
|
1
|
-
# knowledge-writer content coverage
|
|
2
|
-
|
|
3
|
-
## Source to converted-home mapping
|
|
4
|
-
|
|
5
|
-
- Trigger and template entry: `SKILL.md`; input and quality contract: `TEMPLATE.json` requirements, tasks, guidance, and rules.
|
|
6
|
-
- Template compatibility: `TEMPLATE.json` declares the current claw CLI version.
|
|
7
|
-
- Conclusion evidence from every supplied material, with task-status interpretation when present: `non-claw-fallback.md`, template tasks 1 and 2, acceptance criteria, and template rules.
|
|
8
|
-
- Evidence freshness and unresolved-conflict handling: `non-claw-fallback.md`, template task 2, acceptance criteria, and template rules.
|
|
9
|
-
- Runtime scope: `TEMPLATE.json` top-level `scope` only; it is not repeated in writer prompts.
|
|
10
|
-
- Fixed Truth-then-ADR sequence without routing choices: template tasks 4 and 5 and `non-claw-fallback.md`.
|
|
11
|
-
- Machine-stable current/history/superseded metadata and dated evolution grammar: `knowledge-format.md`, template tasks 4 and 5, and `non-claw-fallback.md`.
|
|
12
|
-
- On-write format inspection and repair without corpus-wide migration: `knowledge-format.md`, template tasks 3 through 6, acceptance criteria, and template rules.
|
|
13
|
-
- Canonical-owner discovery and exhaustive search: template tasks 3 through 6 plus template rules.
|
|
14
|
-
- One-owner stewardship and cross-document consistency: template task 6, template rules, and `non-claw-fallback.md`.
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
- [x]
|
|
23
|
-
- [x]
|
|
24
|
-
- [x]
|
|
25
|
-
- [x]
|
|
26
|
-
- [x]
|
|
27
|
-
- [x]
|
|
28
|
-
- [x]
|
|
29
|
-
- [x]
|
|
30
|
-
- [x]
|
|
1
|
+
# knowledge-writer content coverage
|
|
2
|
+
|
|
3
|
+
## Source to converted-home mapping
|
|
4
|
+
|
|
5
|
+
- Trigger and template entry: `SKILL.md`; input and quality contract: `TEMPLATE.json` requirements, tasks, guidance, and rules.
|
|
6
|
+
- Template compatibility: `TEMPLATE.json` declares the current claw CLI version.
|
|
7
|
+
- Conclusion evidence from every supplied material, with task-status interpretation when present: `non-claw-fallback.md`, template tasks 1 and 2, acceptance criteria, and template rules.
|
|
8
|
+
- Evidence freshness and unresolved-conflict handling: `non-claw-fallback.md`, template task 2, acceptance criteria, and template rules.
|
|
9
|
+
- Runtime scope: `TEMPLATE.json` top-level `scope` only; it is not repeated in writer prompts.
|
|
10
|
+
- Fixed Truth-then-ADR sequence without routing choices: template tasks 4 and 5 and `non-claw-fallback.md`.
|
|
11
|
+
- Machine-stable current/history/superseded metadata and dated evolution grammar: `knowledge-format.md`, template tasks 4 and 5, and `non-claw-fallback.md`.
|
|
12
|
+
- On-write format inspection and repair without corpus-wide migration: `knowledge-format.md`, template tasks 3 through 6, acceptance criteria, and template rules.
|
|
13
|
+
- Canonical-owner discovery and exhaustive search: template tasks 3 through 6 plus template rules.
|
|
14
|
+
- One-owner stewardship and cross-document consistency: template task 6, template rules, and `non-claw-fallback.md`.
|
|
15
|
+
- Post-write claw vector and optional GitNexus index refresh: template task 7 through `claw direct`.
|
|
16
|
+
- Writing constraints, encoding, exact identifiers, and return behavior: `non-claw-fallback.md`, template tasks 6 and 7, and template rules.
|
|
17
|
+
- Supplied-material immutability: template task 1, acceptance criteria, template rules, and `non-claw-fallback.md`.
|
|
18
|
+
- Verification gate: template task 6 requires focused and exhaustive post-write review before completion.
|
|
19
|
+
|
|
20
|
+
## Coverage result
|
|
21
|
+
|
|
22
|
+
- [x] Important source triggers and inputs are represented.
|
|
23
|
+
- [x] Conclusion-bearing content from every supplied material drives deposition; task status informs interpretation without turning task metadata into an execution record.
|
|
24
|
+
- [x] The ordered workflow always performs the Truth pass before the ADR pass and has no route-choice task.
|
|
25
|
+
- [x] The finalizer queues project-memory and enabled GitNexus refresh only after the canonical knowledge review succeeds.
|
|
26
|
+
- [x] Search tools, ownership constraints, and safety boundaries are represented.
|
|
27
|
+
- [x] Time-bounded authority, current-anchor checks, and unresolved-freshness no-edit behavior are represented.
|
|
28
|
+
- [x] Writing and consistency verification requirements are represented.
|
|
29
|
+
- [x] Canonical state and dated evolution semantics are represented.
|
|
30
|
+
- [x] Every written owner is repaired to canonical format while untouched documents remain unmigrated.
|
|
31
|
+
- [x] Full direct behavior remains available in the adjacent fallback.
|
|
32
|
+
- [x] No source companion scripts or external links require migration.
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: knowledge-writer
|
|
3
|
-
description: Evaluate supplied materials by their content, then maintain canonical Truth followed by ADR knowledge in one consistency-aware pass. Use only when explicitly invoked with supplied materials; do not trigger this skill implicitly.
|
|
4
|
-
---
|
|
5
|
-
# Knowledge writer
|
|
6
|
-
|
|
1
|
+
---
|
|
2
|
+
name: knowledge-writer
|
|
3
|
+
description: Evaluate supplied materials by their content, then maintain canonical Truth followed by ADR knowledge in one consistency-aware pass. Use only when explicitly invoked with supplied materials; do not trigger this skill implicitly.
|
|
4
|
+
---
|
|
5
|
+
# Knowledge writer
|
|
6
|
+
|
|
7
7
|
Resolve `<skill-dir>` as the directory containing this file.
|
|
8
8
|
|
|
9
9
|
- When this skill owns the supplied finalization assignment as a stage of an active plan, run `claw subplan create --parent <parent-task-name> --task-id <id> --template-file "<skill-dir>/TEMPLATE.json"`.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "knowledge-writer",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.20",
|
|
4
4
|
"scope": "session",
|
|
5
5
|
"title": "knowledge-writer",
|
|
6
6
|
"status": "process.active",
|
|
@@ -136,6 +136,25 @@
|
|
|
136
136
|
"nextsteps": [
|
|
137
137
|
"Report only changed canonical paths and evidence-backed no-edit reasons.",
|
|
138
138
|
"Preserve exact identifiers, repository conventions, and valid Markdown encoding."
|
|
139
|
+
],
|
|
140
|
+
"nextTaskId": 7
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"id": 7,
|
|
147
|
+
"title": "Refresh project search indexes",
|
|
148
|
+
"detail": "From the project root, run `claw direct` after the canonical Truth/ADR review is complete. Confirm that the returned `completionRefresh.asyncRefresh` is queued and includes `memory.reindex.project`; when the project's flat `gitnexus` setting is true, it must also include `gitnexus.refresh`. Do not wait for the detached refresh worker, but do not mark this task done if the command fails or does not queue the refresh.",
|
|
149
|
+
"status": "pending",
|
|
150
|
+
"guidance": {
|
|
151
|
+
"onDone": {
|
|
152
|
+
"default": {
|
|
153
|
+
"mergeMode": "override",
|
|
154
|
+
"summary": "Knowledge governance and the post-write project index refresh are queued.",
|
|
155
|
+
"nextsteps": [
|
|
156
|
+
"Report only changed canonical paths, evidence-backed no-edit reasons, and the queued refresh status path when available.",
|
|
157
|
+
"Preserve exact identifiers, repository conventions, and valid Markdown encoding."
|
|
139
158
|
]
|
|
140
159
|
}
|
|
141
160
|
}
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Knowledge writer fallback
|
|
2
|
-
|
|
3
|
-
Act as the knowledge-base steward for the project. Leave the relevant Truth and ADR corpus accurate, coherent, and easy for future agents to trust.
|
|
4
|
-
|
|
5
|
-
## Input and evidence boundary
|
|
6
|
-
|
|
7
|
-
Read every supplied material completely. Interpret evidence from its content and semantics rather than requiring a particular filename, field, record shape, or serialization format. Extract executed conclusions, verified findings, retrospective lessons, key decisions, and other explicit outcomes wherever they appear. Do not repeat implementation or test verification or modify supplied materials.
|
|
8
|
-
|
|
9
|
-
When task status is present, it helps interpret completed, pending, and blocked scope, but a task list is not an execution log. Infer execution results, verified findings, planning outcomes, and durable decisions from conclusion-bearing content; never turn task titles, descriptions, requirements, or intentions into completed results merely because they appear in an input.
|
|
10
|
-
|
|
11
|
-
## Evidence freshness
|
|
12
|
-
|
|
13
|
-
Trusted means the evidence was verified at the revision or worktree state it describes; it does not make an older report permanently authoritative for current behavior.
|
|
14
|
-
|
|
15
|
-
- Before writing current behavior from a supplied conclusion, read the relevant implementation anchors and inspect later or overlapping working-tree changes. This is a freshness check, not repeated implementation verification; do not rerun tests merely to reconfirm the report.
|
|
16
|
-
- When current implementation supersedes the report, current implementation owns current-state Truth and the report may only support historical or version-bound evidence.
|
|
17
|
-
- If chronology or authority cannot be resolved safely, omit the affected canonical write and retain the freshness conflict as the reason.
|
|
18
|
-
|
|
19
|
-
## Fixed deposition sequence
|
|
20
|
-
|
|
21
|
-
Process the eligible evidence without a route choice:
|
|
22
|
-
|
|
23
|
-
1. Maintain Truth for stable behavior, architecture facts, constraints, pitfalls, code anchors, and verification rules.
|
|
24
|
-
2. Then maintain ADRs for durable decisions, context, rationale, alternatives, tradeoffs, ownership, and consequences, using the same evidence and resulting Truth state.
|
|
25
|
-
3. Finally review Truth and ADR together for ownership and consistency.
|
|
26
|
-
|
|
27
|
-
Use `knowledge-format.md` for every new document and every existing owner written by this pass. Inspect each selected owner before writing and repair nonconforming structure in the same edit; leave untouched documents unmigrated. Dated identifies an evolution checkpoint, not age or time-to-live.
|
|
28
|
-
|
|
29
|
-
It is valid for either pass to make no edit when the eligible evidence contains no new or changed durable knowledge. Temporary progress, speculation, conversational narration, unchanged facts, and unfinished-task claims do not belong in canonical knowledge.
|
|
30
|
-
|
|
31
|
-
## Stewardship and ownership
|
|
32
|
-
|
|
33
|
-
Use `claw search` to discover existing owners, then open every plausible candidate before judging it. Use exhaustive text search for distinguishing identifiers when top-k recall could hide another current claim. Update the document that already owns the topic; create a new document only for a genuinely new durable topic after filename and title collision checks.
|
|
34
|
-
|
|
35
|
-
Maintain one current owner for each material fact or decision. A broad or neighboring document is still a competing owner when it restates an unqualified current rule. Reconcile overlaps by extending the canonical owner and narrowing other current claims to references, historical evidence, or non-overlapping scope. Preserve unrelated user edits and repository conventions.
|
|
36
|
-
|
|
37
|
-
Truth and ADR are one knowledge system: after both ordered passes, review the related documents together and resolve contradictions between current-state Truth, decision ownership, and consequences. Do not report completion while a material current claim remains inconsistent or ownerless.
|
|
38
|
-
|
|
39
|
-
## Writing and verification
|
|
40
|
-
|
|
41
|
-
- Follow the repository's language and document shape.
|
|
42
|
-
- Preserve exact identifiers, config keys, commands, and error text.
|
|
43
|
-
- Use project-relative paths in canonical documents.
|
|
44
|
-
- Ground every fact, path, owner, and alternative in supplied or inspected evidence.
|
|
45
|
-
- Label historical and superseded evidence explicitly; never silently promote it to current behavior.
|
|
46
|
-
- Add dated evolution only for former facts or decisions that remain useful for rollback, compatibility, feature repetition, incident reasoning, or understanding a meaningful transition.
|
|
47
|
-
- Repair every written Truth or ADR owner to the canonical format in `knowledge-format.md`; do not defer a discovered format mismatch.
|
|
48
|
-
- Repair mojibake and preserve valid Markdown encoding.
|
|
49
|
-
- Re-run focused and exhaustive searches after writing; every plausible hit must be the selected owner, an explicit reference, historical or version-bound evidence, or a narrowed non-overlapping claim.
|
|
50
|
-
|
|
51
|
-
## Return
|
|
52
|
-
|
|
53
|
-
Return a brief completion note with changed paths or the evidence-backed no-edit reasons. Response format is not part of the contract.
|
|
1
|
+
# Knowledge writer fallback
|
|
2
|
+
|
|
3
|
+
Act as the knowledge-base steward for the project. Leave the relevant Truth and ADR corpus accurate, coherent, and easy for future agents to trust.
|
|
4
|
+
|
|
5
|
+
## Input and evidence boundary
|
|
6
|
+
|
|
7
|
+
Read every supplied material completely. Interpret evidence from its content and semantics rather than requiring a particular filename, field, record shape, or serialization format. Extract executed conclusions, verified findings, retrospective lessons, key decisions, and other explicit outcomes wherever they appear. Do not repeat implementation or test verification or modify supplied materials.
|
|
8
|
+
|
|
9
|
+
When task status is present, it helps interpret completed, pending, and blocked scope, but a task list is not an execution log. Infer execution results, verified findings, planning outcomes, and durable decisions from conclusion-bearing content; never turn task titles, descriptions, requirements, or intentions into completed results merely because they appear in an input.
|
|
10
|
+
|
|
11
|
+
## Evidence freshness
|
|
12
|
+
|
|
13
|
+
Trusted means the evidence was verified at the revision or worktree state it describes; it does not make an older report permanently authoritative for current behavior.
|
|
14
|
+
|
|
15
|
+
- Before writing current behavior from a supplied conclusion, read the relevant implementation anchors and inspect later or overlapping working-tree changes. This is a freshness check, not repeated implementation verification; do not rerun tests merely to reconfirm the report.
|
|
16
|
+
- When current implementation supersedes the report, current implementation owns current-state Truth and the report may only support historical or version-bound evidence.
|
|
17
|
+
- If chronology or authority cannot be resolved safely, omit the affected canonical write and retain the freshness conflict as the reason.
|
|
18
|
+
|
|
19
|
+
## Fixed deposition sequence
|
|
20
|
+
|
|
21
|
+
Process the eligible evidence without a route choice:
|
|
22
|
+
|
|
23
|
+
1. Maintain Truth for stable behavior, architecture facts, constraints, pitfalls, code anchors, and verification rules.
|
|
24
|
+
2. Then maintain ADRs for durable decisions, context, rationale, alternatives, tradeoffs, ownership, and consequences, using the same evidence and resulting Truth state.
|
|
25
|
+
3. Finally review Truth and ADR together for ownership and consistency.
|
|
26
|
+
|
|
27
|
+
Use `knowledge-format.md` for every new document and every existing owner written by this pass. Inspect each selected owner before writing and repair nonconforming structure in the same edit; leave untouched documents unmigrated. Dated identifies an evolution checkpoint, not age or time-to-live.
|
|
28
|
+
|
|
29
|
+
It is valid for either pass to make no edit when the eligible evidence contains no new or changed durable knowledge. Temporary progress, speculation, conversational narration, unchanged facts, and unfinished-task claims do not belong in canonical knowledge.
|
|
30
|
+
|
|
31
|
+
## Stewardship and ownership
|
|
32
|
+
|
|
33
|
+
Use `claw search` to discover existing owners, then open every plausible candidate before judging it. Use exhaustive text search for distinguishing identifiers when top-k recall could hide another current claim. Update the document that already owns the topic; create a new document only for a genuinely new durable topic after filename and title collision checks.
|
|
34
|
+
|
|
35
|
+
Maintain one current owner for each material fact or decision. A broad or neighboring document is still a competing owner when it restates an unqualified current rule. Reconcile overlaps by extending the canonical owner and narrowing other current claims to references, historical evidence, or non-overlapping scope. Preserve unrelated user edits and repository conventions.
|
|
36
|
+
|
|
37
|
+
Truth and ADR are one knowledge system: after both ordered passes, review the related documents together and resolve contradictions between current-state Truth, decision ownership, and consequences. Do not report completion while a material current claim remains inconsistent or ownerless.
|
|
38
|
+
|
|
39
|
+
## Writing and verification
|
|
40
|
+
|
|
41
|
+
- Follow the repository's language and document shape.
|
|
42
|
+
- Preserve exact identifiers, config keys, commands, and error text.
|
|
43
|
+
- Use project-relative paths in canonical documents.
|
|
44
|
+
- Ground every fact, path, owner, and alternative in supplied or inspected evidence.
|
|
45
|
+
- Label historical and superseded evidence explicitly; never silently promote it to current behavior.
|
|
46
|
+
- Add dated evolution only for former facts or decisions that remain useful for rollback, compatibility, feature repetition, incident reasoning, or understanding a meaningful transition.
|
|
47
|
+
- Repair every written Truth or ADR owner to the canonical format in `knowledge-format.md`; do not defer a discovered format mismatch.
|
|
48
|
+
- Repair mojibake and preserve valid Markdown encoding.
|
|
49
|
+
- Re-run focused and exhaustive searches after writing; every plausible hit must be the selected owner, an explicit reference, historical or version-bound evidence, or a narrowed non-overlapping claim.
|
|
50
|
+
|
|
51
|
+
## Return
|
|
52
|
+
|
|
53
|
+
Return a brief completion note with changed paths or the evidence-backed no-edit reasons. Response format is not part of the contract.
|