@cratis/pi 7.1.2 → 7.1.3
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.
|
@@ -21,10 +21,13 @@ dumps, and similar coordination files. These are **work records, not documentati
|
|
|
21
21
|
- Knowledge that must outlive the session (real documentation, ADRs, operator
|
|
22
22
|
guides) is written deliberately into the repository's documentation structure
|
|
23
23
|
through normal review — not left behind as a work record.
|
|
24
|
-
- **A worktree is a work record too.**
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
24
|
+
- **A worktree is a work record too.** Create it outside the repository tree, for
|
|
25
|
+
example in a sibling `../.worktrees/` directory. A nested worktree inherits the
|
|
26
|
+
parent's `.globalconfig` alongside its own, causing .NET's `MultipleGlobalAnalyzerKeys`
|
|
27
|
+
errors or silently changing analyzer severities. Remove the worktree you created for
|
|
28
|
+
a task once its branch is merged to the default branch — pushed is not merged. Do it
|
|
29
|
+
from the parent checkout, after `git status --ignored` in the worktree, because a
|
|
30
|
+
nested `.ai-work/`, `.env` files and local databases are ignored and are deleted with it.
|
|
28
31
|
If the branch must outlive the task unmerged, leave the worktree and say so in the
|
|
29
32
|
handoff. Never `--force` a removal; a refusal means look, not push harder.
|
|
30
33
|
- **A decision log is not a work record.** A decision — a durable choice with a
|
|
@@ -14,9 +14,10 @@ a sentence chopped short for rhythm.
|
|
|
14
14
|
This skill works from what can be counted and what can be checked. Three things go wrong:
|
|
15
15
|
a handful of constructions recur often enough to be worth a second look, a body of work
|
|
16
16
|
falls into one shape, and underneath both, something only the author knew is missing.
|
|
17
|
-
It revises existing material.
|
|
18
|
-
**cratis-
|
|
19
|
-
**cratis-
|
|
17
|
+
It revises existing material. For drafting, use the skill for the content type:
|
|
18
|
+
**cratis-release-notes** for release notes and **cratis-technical-examples** for code
|
|
19
|
+
samples (both profiles), **cratis-social-feed-post** for feed posts (`cratis/content`) and
|
|
20
|
+
**cratis-documentation-writing** for pages (`cratis/documentation`).
|
|
20
21
|
|
|
21
22
|
The full catalog of patterns is in [references/ai-tells.md](references/ai-tells.md), with a
|
|
22
23
|
word list or regex and a batch threshold for each, and the studies behind them. IDs such as
|
|
@@ -24,6 +24,8 @@
|
|
|
24
24
|
{ "kind": "skill-contains", "value": "Copy in the first person needs the named author's own input" },
|
|
25
25
|
{ "kind": "skill-contains", "value": "lacks clear perspective" },
|
|
26
26
|
{ "kind": "skill-contains", "value": "Cratis applies it, as its own stricter policy" },
|
|
27
|
-
{ "kind": "skill-contains", "value": "references/ai-tells.md" }
|
|
27
|
+
{ "kind": "skill-contains", "value": "references/ai-tells.md" },
|
|
28
|
+
{ "kind": "skill-contains", "value": "samples (both profiles), **cratis-social-feed-post** for feed posts (`cratis/content`)" },
|
|
29
|
+
{ "kind": "skill-contains", "value": "**cratis-documentation-writing** for pages (`cratis/documentation`)" }
|
|
28
30
|
]
|
|
29
31
|
}
|