toga-ai 1.0.38 → 1.0.40
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 +32 -4
package/package.json
CHANGED
package/skills/capture/SKILL.md
CHANGED
|
@@ -71,6 +71,32 @@ 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
|
+
`owners` is a **list of everyone who has worked on the doc — it may hold several names**,
|
|
90
|
+
not just one. Always include `AUTHOR_USERNAME`, and treat the field as cumulative:
|
|
91
|
+
|
|
92
|
+
- **New doc:** start `owners` with `["<AUTHOR_USERNAME>"]`.
|
|
93
|
+
- **Existing doc:** **union** — keep all existing owners and add `AUTHOR_USERNAME` if not
|
|
94
|
+
already present. Never replace or drop an existing owner.
|
|
95
|
+
- **Co-authors:** if more than one person worked on this feature (e.g. pairing, or a handoff
|
|
96
|
+
this session), ask "Anyone else who should be listed as an owner? (usernames, comma-separated,
|
|
97
|
+
same first-initial+last-name convention)" and add each — deduplicated, lowercase — to the list.
|
|
98
|
+
- Never leave `owners` empty.
|
|
99
|
+
|
|
74
100
|
## Step 2 — Determine framework / repo / project (ask if unknown)
|
|
75
101
|
|
|
76
102
|
1. From the **live session context**, identify what was built, changed, debugged, or decided,
|
|
@@ -118,6 +144,8 @@ Write all docs to `<TEAM_REPO>/knowledge/...` — the git clone, not the project
|
|
|
118
144
|
|
|
119
145
|
For every doc, set/refresh frontmatter: `framework`, `repo`, `project`, `client`,
|
|
120
146
|
`type`, `status`, `updated` (today's date), `owners`, `files`, `related`.
|
|
147
|
+
Set `owners` to `["<AUTHOR_USERNAME>"]` from Step 1b — **never leave it empty**; when a doc
|
|
148
|
+
already has owners, add `AUTHOR_USERNAME` if missing rather than replacing.
|
|
121
149
|
Add `related:` cross-links. Append new repos to `<TEAM_REPO>/knowledge/registry.json`.
|
|
122
150
|
|
|
123
151
|
## Step 6 — Validate, index, mirror back (mandatory)
|
|
@@ -224,7 +252,7 @@ client: <shared|client-slug>
|
|
|
224
252
|
type: <feature|client-feature>
|
|
225
253
|
status: active
|
|
226
254
|
updated: <YYYY-MM-DD>
|
|
227
|
-
owners: [<
|
|
255
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
228
256
|
files:
|
|
229
257
|
- <on-disk/path/one>
|
|
230
258
|
related: [] # client-feature: link the shared apps/<repo>/features/<base>.md
|
|
@@ -262,7 +290,7 @@ client: <client-slug>
|
|
|
262
290
|
type: workflow
|
|
263
291
|
status: active
|
|
264
292
|
updated: <YYYY-MM-DD>
|
|
265
|
-
owners: [<
|
|
293
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
266
294
|
files: []
|
|
267
295
|
related: []
|
|
268
296
|
---
|
|
@@ -291,7 +319,7 @@ client: shared
|
|
|
291
319
|
type: architecture
|
|
292
320
|
status: active
|
|
293
321
|
updated: <YYYY-MM-DD>
|
|
294
|
-
owners: [<
|
|
322
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
295
323
|
files: [<key paths>]
|
|
296
324
|
related: []
|
|
297
325
|
---
|
|
@@ -310,7 +338,7 @@ client: shared
|
|
|
310
338
|
type: standard
|
|
311
339
|
status: active
|
|
312
340
|
updated: <YYYY-MM-DD>
|
|
313
|
-
owners: [<
|
|
341
|
+
owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
|
|
314
342
|
files: []
|
|
315
343
|
related: []
|
|
316
344
|
---
|