genesis-compiler 1.10.12 → 1.10.13
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
CHANGED
|
@@ -736,9 +736,13 @@ The eight task types are deliberately explicit:
|
|
|
736
736
|
- `describe` creates or refreshes both the non-technical Blueprint and the
|
|
737
737
|
complete useful Program from the current codebase, optional user guidance,
|
|
738
738
|
and selected Stack guidance where it affects accurate explanation.
|
|
739
|
-
- `review`
|
|
740
|
-
|
|
741
|
-
|
|
739
|
+
- `review` asks the agent to compare Blueprint, code, Program, and tests,
|
|
740
|
+
identify contradictions and gaps, and distinguish evidence from inference.
|
|
741
|
+
It judges the tests too: the relevant ones run and pass, with what ran and
|
|
742
|
+
what was not verified reported; changed behavior has tests; no test was
|
|
743
|
+
weakened, skipped, deleted or loosened to pass; and the changed tests stay
|
|
744
|
+
fast against coarse sanity limits. It edits only tests, writing the missing
|
|
745
|
+
ones or reporting those it cannot.
|
|
742
746
|
|
|
743
747
|
Prompt generation is read-only. Missing external resources are reported in
|
|
744
748
|
the prompt but do not prevent its generation. Genesis never invents values.
|
|
@@ -161,8 +161,18 @@ before selection. For an existing uninitialized codebase it owns
|
|
|
161
161
|
the adoption recommendation as part of the same portable prompt. A host sends this prompt on the
|
|
162
162
|
first chat turn; it does not recreate the questions or Stack catalog.
|
|
163
163
|
`describe` creates or refreshes the complete Blueprint and useful Program in one
|
|
164
|
-
agent task.
|
|
165
|
-
|
|
164
|
+
agent task. `review` is the generic review contract a host gives an agent after
|
|
165
|
+
a piece of work. Besides comparing Blueprint, code, Program and tests, it has
|
|
166
|
+
the agent judge the tests: the relevant ones run and pass, with what ran and
|
|
167
|
+
what was not verified reported; changed behavior has new or updated tests,
|
|
168
|
+
written in the review or reported when they cannot be; a test weakened,
|
|
169
|
+
skipped, deleted or loosened to pass is a finding; and the changed tests stay
|
|
170
|
+
fast against coarse sanity limits (a suite never runs for hours, a test needing
|
|
171
|
+
minutes is a smell, a test database is ready in seconds), never per-test
|
|
172
|
+
budgets. It points at the project skill's verification section and the sanity
|
|
173
|
+
checks guide rather than restating them, and edits only tests. The host owns
|
|
174
|
+
the agent and its interaction. Genesis owns only transparent prompt
|
|
175
|
+
construction and deterministic project operations.
|
|
166
176
|
|
|
167
177
|
## Instruction sources
|
|
168
178
|
|
package/package.json
CHANGED
package/prompts/review.txt
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
Read `.agents/skills/genesis-project/SKILL.md` and
|
|
2
|
-
`.agents/skills/genesis-program/SKILL.md` completely, then
|
|
3
|
-
review.
|
|
2
|
+
`.agents/skills/genesis-program/SKILL.md` completely, then review the work.
|
|
4
3
|
|
|
5
4
|
Compare Blueprint intent, observable implementation, tests, Program public
|
|
6
5
|
contracts, informational implementation maps, and recorded verification in both
|
|
@@ -8,6 +7,21 @@ directions. Identify missing or contradictory behavior, misleading explanation,
|
|
|
8
7
|
unnecessarily difficult public shape, and verification gaps. Distinguish direct
|
|
9
8
|
evidence from inference and state questions that require human intent.
|
|
10
9
|
|
|
10
|
+
Judge the tests as part of the work, with the project skill's "Verify and
|
|
11
|
+
report" section and the test sections of the sanity checks guide:
|
|
12
|
+
- Run the tests relevant to the change, through the Stack's verification
|
|
13
|
+
commands or focused checks; a failure is a finding. Report what actually ran
|
|
14
|
+
and anything not verified; never report an unrun check as passing.
|
|
15
|
+
- Changed behavior has tests, new or updated, that would fail without it. Write
|
|
16
|
+
the missing ones as part of this review; when that is not possible, report
|
|
17
|
+
each with the behavior it should prove.
|
|
18
|
+
- A test weakened, skipped, deleted or loosened just to make things pass is a
|
|
19
|
+
finding, reported like a product defect.
|
|
20
|
+
- Tests stay fast. Look at what the changed tests cost and where their time
|
|
21
|
+
goes. Coarse sanity limits, never per-test budgets: a whole suite never runs
|
|
22
|
+
for hours, one test that needs minutes is a smell, and a test database is
|
|
23
|
+
ready in seconds.
|
|
24
|
+
|
|
11
25
|
Report what makes requests or tests slower than their work, citing a count or
|
|
12
26
|
timing where one exists and the code path otherwise: a list or batch whose
|
|
13
27
|
query count grows with its rows, an access check whose cost grows with stored
|
|
@@ -21,7 +35,9 @@ access decided from ids the client sends rather than the trusted context.
|
|
|
21
35
|
Judge each against the matching section and outer limit of
|
|
22
36
|
`.agents/skills/genesis-project/references/sanity-checks.md`.
|
|
23
37
|
|
|
24
|
-
|
|
25
|
-
|
|
38
|
+
Edit only tests: add or update the tests the changed behavior lacks, and change
|
|
39
|
+
no product code, Blueprint, Program, Stack or other file. Return a concise
|
|
40
|
+
report ordered by impact with exact file references, the evidence inspected,
|
|
41
|
+
the tests run and written, and the smallest sensible correction.
|
|
26
42
|
|
|
27
43
|
Review `genesis/subsystems.md` responsibilities, Program membership, and data ownership/use against source and schema. Report missing, stale, or conflicting associations without editing them.
|
|
@@ -71,14 +71,14 @@ Program module.
|
|
|
71
71
|
## Task boundaries
|
|
72
72
|
|
|
73
73
|
The caller determines whether this is initial description, complete Program
|
|
74
|
-
refresh, focused post-change reconciliation, Blueprint-only work, or
|
|
75
|
-
|
|
74
|
+
refresh, focused post-change reconciliation, Blueprint-only work, or review.
|
|
75
|
+
Respect the caller's edit boundary. Report ambiguity rather than
|
|
76
76
|
inventing intent.
|
|
77
77
|
|
|
78
78
|
## Subsystems
|
|
79
79
|
|
|
80
80
|
Maintain `genesis/subsystems.md` alongside Program in description and refresh
|
|
81
|
-
work. Blueprint-only work
|
|
81
|
+
work. Blueprint-only work and review do not change the map.
|
|
82
82
|
The map is the authored association authority, but responsibilities and table
|
|
83
83
|
references remain fallible explanations of application source and schema.
|
|
84
84
|
|