gcf-aif-ext 0.20.2 → 0.22.0
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/GLOSSARY.md +26 -0
- package/README.md +19 -0
- package/commands/gcf.js +92 -6
- package/extension.json +6 -1
- package/injections/improve-plan.md +7 -0
- package/injections/plan-context.md +10 -1
- package/lib/bundle.js +4 -5
- package/lib/changes.js +643 -0
- package/lib/config-set.js +19 -1
- package/lib/design-check.js +47 -18
- package/lib/design-parts.js +27 -17
- package/lib/design.js +24 -3
- package/lib/domain.js +4 -2
- package/lib/edits.js +2 -13
- package/lib/gate.js +13 -1
- package/lib/gcf-paths.js +10 -0
- package/lib/git.js +22 -2
- package/lib/index-gen.js +5 -4
- package/lib/linter.js +5 -3
- package/lib/plan-check.js +52 -2
- package/lib/tree-file.js +107 -0
- package/node_modules/cnlp-kit/CHANGELOG.md +23 -0
- package/node_modules/cnlp-kit/README.md +27 -1
- package/node_modules/cnlp-kit/bin/cnlp.js +1 -1
- package/node_modules/cnlp-kit/cnlp-format.md +13 -0
- package/node_modules/cnlp-kit/package.json +1 -1
- package/node_modules/cnlp-kit/profiles/glossary.md +38 -0
- package/node_modules/cnlp-kit/skills/cnlp-glossary/SKILL.md +50 -0
- package/node_modules/cnlp-kit/src/cnlp.js +10 -5
- package/node_modules/cnlp-kit/src/config.js +40 -3
- package/package.json +3 -2
- package/profiles/game.md +6 -0
- package/profiles/glossary.md +15 -14
- package/profiles/plan.md +52 -0
- package/skills/gcf-adopt/SKILL.md +1 -1
- package/skills/gcf-ingest/SKILL.md +4 -4
- package/skills/gcf-init/SKILL.md +1 -1
- package/skills/gcf-vision/SKILL.md +1 -1
- package/templates/agents-block.md +7 -2
- package/templates/config.yml +4 -0
- package/templates/game.md +3 -0
- package/templates/glossary.md +5 -5
|
@@ -41,7 +41,7 @@ workflow:
|
|
|
41
41
|
8. state the next step: `/gcf-init` for the pillars interview, `/gcf-debate` to stress the design, then `/gcf-card <id>` for the first unit
|
|
42
42
|
9. to change the vision, scope or milestones later, read `gcf/game.md`, ask what changes, write only the blocks that change, and read them back to the human
|
|
43
43
|
10. a milestone renamed while units cite it fails the design check: change the `milestone:` of each citing unit too, then run `ai-factory gcf design check` and `ai-factory gcf design commit -m "<what changed>"`
|
|
44
|
-
11. a draft of the glossary (the board's Draft with agent): from `gcf/game.md` and the units, write `
|
|
44
|
+
11. a draft of the glossary (the board's Draft with agent): from `gcf/game.md` and the units, write `GLOSSARY.md` as `templates/glossary.md`, no `avoid: TBD`; do not record it: the human records, edits or discards it
|
|
45
45
|
12. a draft of a subsystem's purpose: read its units in `gcf/design/<system>.md` and `gcf/game.md`, write its `purpose:` block, change nothing else, and do not record it
|
|
46
46
|
|
|
47
47
|
invocation:
|
|
@@ -11,6 +11,8 @@ gcf_work:
|
|
|
11
11
|
- an agent names the category: `ai-factory gcf inbox categories` lists them and who may file each; yours are `request` (what only a person can give: a file, an asset, an access), `bug`, `finding` (a remark about the code or the project: a risk, debt, an analyzer's warning), `idea`, and `playtest` for the human's words in a playtest session; a remark about the code is a `finding`, never a failure, which only a CI job files
|
|
12
12
|
- a text of several lines (its first line becomes the title) goes through stdin: `ai-factory gcf inbox add --text-file - <<'EOF'`, the lines, then `EOF`
|
|
13
13
|
- before planning an item, run `ai-factory gcf context <id>` and read only the files it lists under `gcf/`
|
|
14
|
+
- an item's plan is in the plan form: blocks `context:`, `decisions:` (records `id`, `pick`, `why`), `tasks:` (`- [ ] t1 <action> (d1)`), `pillar_check:`, `verification:`, one idea a line
|
|
15
|
+
- `ai-factory gcf plan check <id>` lists the plan's form problems as `format:` lines: fix them, they never block
|
|
14
16
|
- drive a ready item with the gcf-run skill when the project has gcf-harness-aif-ext and the agent is Claude Code (a batch at once: `ai-factory gcf-harness run <ids...>`), otherwise with aif-plan and aif-implement
|
|
15
17
|
- a question about how the runs go (the share that reached their move, cost, plan checks, DoD attempts, guard firings) is answered by `ai-factory gcf-harness metrics`
|
|
16
18
|
- a question about past runs (an item's results, what it ran on, its cost, the part of its log a run wrote) is answered by `ai-factory gcf-harness runs [--item <id>] --json`; `ai-factory gcf-harness run <ids...> --model <m> --effort <e>` runs items on another model for that run only, the item unchanged
|
|
@@ -22,7 +24,8 @@ gcf_work:
|
|
|
22
24
|
- work that cannot go on: run `ai-factory gcf block <id> --reason "<why or the question>"`
|
|
23
25
|
- in a worktree on branch `work/<id>` change no `gcf/` file but the item's `live:` and new inbox entries, commit all, then run `ai-factory gcf verify <id> --mark`: `ai-factory gcf integrate` in the main checkout merges it and records the move
|
|
24
26
|
- a design question only the human can answer becomes a D1 record in `gcf/open-questions.md`
|
|
25
|
-
- a word added to
|
|
27
|
+
- name each thing by the term `GLOSSARY.md` defines for it; a word added to an `avoid:` there leaves `gcf/design/`, `gcf/systems/`, `gcf/PILLARS.md` and every item but an unplayed one in the same commit: `ai-factory gcf design check` names each hit in design and items as M4, `npx --yes cnlp-kit check` the rest
|
|
28
|
+
- an `avoid:` lists only a word wrong in every document: a word with another use stays out, a phrase ("tile hand") beats a bare word
|
|
26
29
|
- the human plays from `ai-factory gcf playtest session`; each free note from that play goes to `ai-factory gcf inbox add --category playtest "<note>"`, in the human's words
|
|
27
30
|
- a release item carries `version:` and `channel:` (`item new --title "<title>" --type release --release <v> --channel <c>`): its end writes the `release:` block of `gcf/LIVE.md`
|
|
28
31
|
- `item new` and `take` refuse a type the current phase does not take: run `ai-factory gcf phase` and bring the refusal to the human
|
|
@@ -38,7 +41,7 @@ gcf_work:
|
|
|
38
41
|
- what happened to an item before (who submitted, blocked, tuned or reranked it, and when) is `ai-factory gcf item history <id>`: its moves from git, an ended item's too
|
|
39
42
|
- a picture or file the human gives an item goes to `ai-factory gcf item attach <id> --file <path>` (its `gcf/work/<id>/attachments/`, committed); read an item's attachments before you plan it
|
|
40
43
|
- write what the human reads (a question, an assumption, a block reason, an inbox entry, a lesson, a report, an item's `title:`) in `language.ui` of `.ai-factory/config.yaml`, and the body of an item that is not a design unit in its `language.artifacts`
|
|
41
|
-
- write in English whatever lands in a checked document: `gcf/design/`, `gcf/systems/`, `
|
|
44
|
+
- write in English whatever lands in a checked document: `gcf/design/`, `gcf/systems/`, `GLOSSARY.md`, `gcf/PILLARS.md`, `gcf/LIVE.md`, the body of a design unit's item but its `tuning:` and `notes:`, an item's `live:` summary; an answer that moves into a unit's slot goes there in English
|
|
42
45
|
- never translate keys, statuses, ids, commands, `TBD`, `answer: q-NNN`, `## Handoff`, a `quote:` (it is verbatim from the GDD) or the fixed start of a block reason (`needs permission:`, `plan did not converge:`, `waits for`)
|
|
43
46
|
- a D1 record that carries the human's `answer:` goes into the slot of each unit it blocks, with `answer: q-NNN`, and then leaves `gcf/open-questions.md`
|
|
44
47
|
- a pillar changes only on the human's word; its short `name:` is what the human knows it by, and its id comes from the name: a new name saved with `design save` renames the id wherever it is cited; `ai-factory gcf pillar retire <id> --reason "<why>"` takes one out
|
|
@@ -49,6 +52,8 @@ gcf_work:
|
|
|
49
52
|
- in the project chat (the gcf-chat skill) a new item is proposed with the `propose_item_new` tool of the `gcf` MCP server, not made with `item new`: the human's click makes it; so are a block, a drop, a dependency change, an unblock, a verdict, a decision, an answer to an open question and the inbox's add, category, Later and erase, with their `propose_` tools and the `id` they act on; a new item is proposed by its title, never an id
|
|
50
53
|
- a verdict is proposed only after the human said in the talk that they played the item and how it felt, its note in the human's words; the `remove` of a kill, a no or a wontfix is left to the rule unless the human says otherwise
|
|
51
54
|
- a move refused for hand edits under `gcf/` ends its error with `gcf-refusal: {"code":"dirty","paths":[…]}`: `ai-factory gcf edits diff --path <path>` shows them; `gcf edits commit` and `gcf edits discard` are the human's moves, never the agent's
|
|
55
|
+
- a move the commit gate refuses ends its error with `gcf-refusal: {"code":"gate","problems":[…]}`: nothing was committed; fix what it names, then make the move again
|
|
56
|
+
- `ai-factory gcf changes [--worktree <id>]` lists what is uncommitted in the checkout or an item's worktree, `gcf changes diff --path <path>` shows one text file's diff; `no_diff` in `gcf/config.yml` is the project's list of files shown without a diff
|
|
52
57
|
- a chat thread bound to an item reads the item's file, its plan, its run's log and run chat first (the paths its context names), answers the question, and only then proposes a move
|
|
53
58
|
|
|
54
59
|
gcf_forbidden:
|
package/templates/config.yml
CHANGED
|
@@ -33,6 +33,10 @@ auto_compact_pct: 0
|
|
|
33
33
|
# template: ../my-template
|
|
34
34
|
# questions:
|
|
35
35
|
# - which step of this item took the longest, and why?
|
|
36
|
+
# Files the board's Changes screen lists and never opens: generated text nobody reads as a diff.
|
|
37
|
+
# GCF names no stack's files, so the list is yours; a `*` stays in one folder. Uncomment to set:
|
|
38
|
+
# no_diff:
|
|
39
|
+
# - "**/*.prefab"
|
|
36
40
|
# What agent runs may not do lives in an `agent:` section that `ai-factory gcf permissions`
|
|
37
41
|
# and the board write; without it the default deny groups hold.
|
|
38
42
|
# The project's own commands for the auto DoD (Methodology §6); the engine does not matter.
|
package/templates/game.md
CHANGED
package/templates/glossary.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
+
purpose:
|
|
2
|
+
- a short-session puzzle about placing tiles on a small board: the names of its pieces and places
|
|
3
|
+
|
|
1
4
|
terms:
|
|
2
5
|
- term: tile tray
|
|
3
6
|
means: the supply of unplaced tiles the player picks from
|
|
4
|
-
|
|
7
|
+
avoid: tile hand
|
|
5
8
|
|
|
6
9
|
- term: void cell
|
|
7
10
|
means: a cell a shaped board leaves out
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
units:
|
|
11
|
-
- coins: the soft currency
|
|
11
|
+
avoid: blocked cell
|