toga-ai 1.0.38 → 1.0.39
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/package.json +1 -1
- package/skills/capture/SKILL.md +26 -4
package/package.json
CHANGED
package/skills/capture/SKILL.md
CHANGED
|
@@ -71,6 +71,26 @@ persist the `.claude/` bundle path, or the next session will silently skip pushi
|
|
|
71
71
|
|
|
72
72
|
Call the helper as `node "<TEAM_REPO>/knowledge.js" …`.
|
|
73
73
|
|
|
74
|
+
## Step 1b — Resolve the author username (`owners` — NEVER leave empty)
|
|
75
|
+
|
|
76
|
+
Every doc's `owners:` field must name the person authoring this session's changes.
|
|
77
|
+
**Never write `owners: []` or an empty owner.** Resolve the username once and reuse it for
|
|
78
|
+
every doc in this capture — call the result `AUTHOR_USERNAME`:
|
|
79
|
+
|
|
80
|
+
1. **Claude memory** — look for a `user` memory named `author-username`. If present, use it
|
|
81
|
+
and do not ask again.
|
|
82
|
+
2. **If absent, ASK the developer:** "What's your username for knowledge ownership?
|
|
83
|
+
(convention: first initial + last name, all lowercase — e.g. John Smith → `jsmith`)."
|
|
84
|
+
- Do **not** guess from the OS login or git config — ask and confirm.
|
|
85
|
+
- Normalize the answer to lowercase with no spaces.
|
|
86
|
+
3. **Persist it** to Claude memory as a `user` memory named `author-username` (and add its
|
|
87
|
+
`MEMORY.md` pointer) so future captures never ask again.
|
|
88
|
+
|
|
89
|
+
Use `AUTHOR_USERNAME` for `owners` in every doc you write: `owners: ["<AUTHOR_USERNAME>"]`.
|
|
90
|
+
When updating an existing doc that already lists owners, **add** `AUTHOR_USERNAME` if it is
|
|
91
|
+
not already present (do not replace the existing owners). If an existing doc has an empty
|
|
92
|
+
or missing `owners`, fill it with `AUTHOR_USERNAME`.
|
|
93
|
+
|
|
74
94
|
## Step 2 — Determine framework / repo / project (ask if unknown)
|
|
75
95
|
|
|
76
96
|
1. From the **live session context**, identify what was built, changed, debugged, or decided,
|
|
@@ -118,6 +138,8 @@ Write all docs to `<TEAM_REPO>/knowledge/...` — the git clone, not the project
|
|
|
118
138
|
|
|
119
139
|
For every doc, set/refresh frontmatter: `framework`, `repo`, `project`, `client`,
|
|
120
140
|
`type`, `status`, `updated` (today's date), `owners`, `files`, `related`.
|
|
141
|
+
Set `owners` to `["<AUTHOR_USERNAME>"]` from Step 1b — **never leave it empty**; when a doc
|
|
142
|
+
already has owners, add `AUTHOR_USERNAME` if missing rather than replacing.
|
|
121
143
|
Add `related:` cross-links. Append new repos to `<TEAM_REPO>/knowledge/registry.json`.
|
|
122
144
|
|
|
123
145
|
## Step 6 — Validate, index, mirror back (mandatory)
|
|
@@ -224,7 +246,7 @@ client: <shared|client-slug>
|
|
|
224
246
|
type: <feature|client-feature>
|
|
225
247
|
status: active
|
|
226
248
|
updated: <YYYY-MM-DD>
|
|
227
|
-
owners: [<
|
|
249
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
228
250
|
files:
|
|
229
251
|
- <on-disk/path/one>
|
|
230
252
|
related: [] # client-feature: link the shared apps/<repo>/features/<base>.md
|
|
@@ -262,7 +284,7 @@ client: <client-slug>
|
|
|
262
284
|
type: workflow
|
|
263
285
|
status: active
|
|
264
286
|
updated: <YYYY-MM-DD>
|
|
265
|
-
owners: [<
|
|
287
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
266
288
|
files: []
|
|
267
289
|
related: []
|
|
268
290
|
---
|
|
@@ -291,7 +313,7 @@ client: shared
|
|
|
291
313
|
type: architecture
|
|
292
314
|
status: active
|
|
293
315
|
updated: <YYYY-MM-DD>
|
|
294
|
-
owners: [<
|
|
316
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
295
317
|
files: [<key paths>]
|
|
296
318
|
related: []
|
|
297
319
|
---
|
|
@@ -310,7 +332,7 @@ client: shared
|
|
|
310
332
|
type: standard
|
|
311
333
|
status: active
|
|
312
334
|
updated: <YYYY-MM-DD>
|
|
313
|
-
owners: [<
|
|
335
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
314
336
|
files: []
|
|
315
337
|
related: []
|
|
316
338
|
---
|