@elvis1513/auto-coding-skill 4.1.7 → 4.2.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/README.md +66 -24
- package/cli/assets/managed-install.json +1 -0
- package/cli/assets/skill/SKILL.md +22 -10
- package/cli/assets/skill/data/policies/workflow-migrations-v1.json +2 -2
- package/cli/assets/skill/data/templates/ENGINEERING.md +12 -39
- package/cli/assets/skill/data/templates/bridges/AGENTS.md +20 -6
- package/cli/assets/skill/scripts/ap.py +916 -55
- package/cli/assets/skill/scripts/install_integrity.py +424 -0
- package/cli/assets/skill/scripts/scaffold_templates.py +9 -0
- package/cli/src/check-package.js +4 -0
- package/cli/src/index.js +275 -30
- package/cli/src/sync-assets.js +30 -1
- package/cli/tests/ap_concurrency_test.py +311 -6
- package/cli/tests/ap_profiles_test.py +3 -3
- package/cli/tests/index.test.js +218 -83
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -9,9 +9,13 @@ The Skill is a selectable guardrail, not a command sequence that must run for
|
|
|
9
9
|
every task. The model skips machinery whose expected benefit does not exceed its
|
|
10
10
|
cost; read-only work and obvious small clean-checkout changes normally stay direct.
|
|
11
11
|
|
|
12
|
-
Version 4.
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
Version 4.2.0 makes registered closure resilient to normal Git staging, reuses
|
|
13
|
+
an exact successful final gate, and lets an active task expand scope safely
|
|
14
|
+
before its first commit. Version 4.1.9 makes `autocoding init` verify the bounded managed installation after every install or upgrade:
|
|
15
|
+
it replaces every managed constraint, migrates only schema-approved project
|
|
16
|
+
configuration, and converges `docs/` to one canonical directory framework. Version 4.1.7 made
|
|
17
|
+
the Python runtime check, release verification, and tag publication environment
|
|
18
|
+
reproducible while removing the unnecessary `requests` dependency. Version 4.1.4
|
|
15
19
|
made direct continuation provably pre-write, closed self-review and
|
|
16
20
|
risk-classification gaps, validated Agent contracts, and made tag publication
|
|
17
21
|
idempotent. Version 4.1.3 closed classification bypasses. Version 4.1.2 made mechanisms required,
|
|
@@ -28,7 +32,6 @@ affected-scope checks are enabled only when concurrency or risk justifies them.
|
|
|
28
32
|
npm install -g @elvis1513/auto-coding-skill
|
|
29
33
|
python3 -m pip install PyYAML==6.0.3
|
|
30
34
|
autocoding init
|
|
31
|
-
autocoding sync --projects .
|
|
32
35
|
```
|
|
33
36
|
|
|
34
37
|
The project install contains:
|
|
@@ -41,15 +44,17 @@ docs/tools/autopipeline/ap.py
|
|
|
41
44
|
AGENTS.md (fully managed canonical repository contract)
|
|
42
45
|
```
|
|
43
46
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
+
`autocoding init` also installs the exact shared documentation tree under
|
|
48
|
+
`docs/{architecture,bugs,deployment,design,interfaces,project,reviews,testing}`.
|
|
49
|
+
Managed templates are replaced; mutable project docs and valid architecture, ADR,
|
|
50
|
+
interface, DD, review, or deploy-record documents are preserved; unrelated
|
|
51
|
+
directories are archived under `.agents/archive/`. Re-running init is the complete upgrade operation;
|
|
52
|
+
`sync` and project-local `upgrade` are compatibility commands, not required steps.
|
|
47
53
|
|
|
48
54
|
Fill the project/Jenkins/GitLab/Nexus URL, username, and password fields under
|
|
49
55
|
`access.*`, then configure one real fast validation command and run:
|
|
50
56
|
|
|
51
57
|
```bash
|
|
52
|
-
python3 docs/tools/autopipeline/ap.py upgrade --write
|
|
53
58
|
python3 docs/tools/autopipeline/ap.py doctor
|
|
54
59
|
```
|
|
55
60
|
|
|
@@ -85,14 +90,16 @@ Clean serial work proceeds directly on the current branch with normal Git; it do
|
|
|
85
90
|
not create machine lifecycle state. Use `task-start` only when classification
|
|
86
91
|
requires isolation/review or the user explicitly requests lifecycle tracking:
|
|
87
92
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
93
|
+
If a registered task discovers another path before its first commit, expand it
|
|
94
|
+
with `task-scope-add` instead of finishing and restarting. Expansion is explicit,
|
|
95
|
+
lease/conflict checked, risk-monotonic, and invalidates old review/gate state.
|
|
96
|
+
Unregistered direct work should reclassify before writing outside its clean claim.
|
|
92
97
|
|
|
93
98
|
```bash
|
|
94
99
|
python3 docs/tools/autopipeline/ap.py task-start T0001 \
|
|
95
100
|
--owned-path backend/internal/orders --force-lifecycle
|
|
101
|
+
python3 docs/tools/autopipeline/ap.py task-scope-add T0001 \
|
|
102
|
+
--owned-path config/orders
|
|
96
103
|
python3 docs/tools/autopipeline/ap.py commit-push T0001 \
|
|
97
104
|
--msg "T0001: fix order retry"
|
|
98
105
|
```
|
|
@@ -172,6 +179,10 @@ closure gate is limited to one stable-diff run. Full regression, Docker, builds,
|
|
|
172
179
|
Jenkins, deployment, API verification, and target checks remain explicit
|
|
173
180
|
diagnostics outside normal closure.
|
|
174
181
|
|
|
182
|
+
Registered tasks call `commit-push` directly because it performs or strictly
|
|
183
|
+
reuses that final gate. Run `light-gate` manually only for unregistered normal Git
|
|
184
|
+
closure or when explicitly requesting a fresh diagnostic pass.
|
|
185
|
+
|
|
175
186
|
The recommended final closure defaults are 120 seconds per command and 180
|
|
176
187
|
seconds total. Projects may raise them for measured affected-scope checks or set
|
|
177
188
|
a smaller `timeout_seconds` on a route. A timeout calls for a narrower route and
|
|
@@ -194,24 +205,55 @@ integration, push, and cleanup. Push ends the coding task; later CI/acceptance i
|
|
|
194
205
|
not polled automatically. An explicitly requested failure diagnosis may continue
|
|
195
206
|
in the same conversation/task without an artificial second ledger lifecycle.
|
|
196
207
|
|
|
197
|
-
## Upgrade
|
|
208
|
+
## Upgrade projects
|
|
198
209
|
|
|
199
|
-
Finish every registered task using its currently installed runtime before
|
|
200
|
-
|
|
201
|
-
|
|
210
|
+
Finish every registered task using its currently installed runtime before changing
|
|
211
|
+
the Skill version. Then run `autocoding init` from each project root. It is safe to
|
|
212
|
+
rerun and needs no force flag.
|
|
202
213
|
|
|
203
214
|
```bash
|
|
215
|
+
cd /path/a && autocoding init
|
|
216
|
+
cd /path/b && autocoding init
|
|
204
217
|
autocoding status --projects /path/a,/path/b
|
|
205
|
-
autocoding sync --projects /path/a,/path/b --dry-run
|
|
206
|
-
autocoding sync --projects /path/a,/path/b
|
|
207
218
|
```
|
|
208
219
|
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
220
|
+
Init replaces the managed Skill, root `AGENTS.md`, managed agents, ENGINEERING
|
|
221
|
+
schema/body, runtime launcher, and documentation framework. It preserves explicit
|
|
222
|
+
model overrides and current values at supported project/access/concurrency/route
|
|
223
|
+
fields. Removed content is archived outside active docs.
|
|
224
|
+
|
|
225
|
+
## What changed in 4.2.0
|
|
226
|
+
|
|
227
|
+
- Made `commit-push` preserve already staged deletions and mixed index/worktree
|
|
228
|
+
state, and made ownership/validation see both ends of a rename.
|
|
229
|
+
- Added an exact per-worktree final-gate PASS receipt. Registered `commit-push`
|
|
230
|
+
reuses it only when content, index, base, scope, validation plan, command hashes,
|
|
231
|
+
and writer lease still match; staging or push retries no longer rerun a stable gate.
|
|
232
|
+
- Added `task-scope-add` for conflict-checked, monotonic scope expansion before the
|
|
233
|
+
first commit. Expansion raises risk when necessary and invalidates review/gate state.
|
|
234
|
+
- Clarified that registered tasks call `commit-push` directly; standalone
|
|
235
|
+
`light-gate` is for unregistered Git closure or an explicit fresh diagnostic.
|
|
236
|
+
|
|
237
|
+
## What changed in 4.1.9
|
|
238
|
+
|
|
239
|
+
- Added a packaged managed-install manifest with path, version, content hash, and
|
|
240
|
+
executable-bit expectations for release-owned files.
|
|
241
|
+
- Made `autocoding init` verify the written Skill, managed agents, root protocol,
|
|
242
|
+
launcher, managed ENGINEERING region, and canonical templates before success.
|
|
243
|
+
- Made `doctor` recheck the local manifest and `status` compare it with the current
|
|
244
|
+
release while excluding project facts, durable records, custom agents, and archives.
|
|
245
|
+
|
|
246
|
+
## What changed in 4.1.8
|
|
247
|
+
|
|
248
|
+
- Made `autocoding init` perform a complete project install or upgrade without a
|
|
249
|
+
separate sync/upgrade chain or `--force`.
|
|
250
|
+
- Rebuilt ENGINEERING from the current schema, preserving only supported project
|
|
251
|
+
values and removing unknown legacy fields and competing workflow text.
|
|
252
|
+
- Made the generated docs directory topology and managed templates identical
|
|
253
|
+
across projects while preserving mutable project docs and valid durable records;
|
|
254
|
+
obsolete paths are archived under `.agents/archive/` before removal.
|
|
255
|
+
- Made root AGENTS, managed agents, the Skill copy, and the project launcher fully
|
|
256
|
+
converge during init.
|
|
215
257
|
|
|
216
258
|
## What changed in 4.1.7
|
|
217
259
|
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"schema_version":1,"skill_version":"4.2.0","manifest_path":".agents/managed-install.json","entries":[{"path":".agents/agents/browser-debugger.toml","source":"agents/browser-debugger.toml","ownership":"normalized-agent","sha256":"40727952944917eb0b573bb96dca2906c27bc794737f3b6b392b56df7b4208aa","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"f3a0adc06bba44ea81e1b10c6e353f53ece555c55f9e2990276f4c12a483f318","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"b5e61e74adc5f172a191d027195f921e994239904edf08773094234256bab410","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json","source":"skill/data/contracts/orchestration-v1.schema.json","ownership":"exact","sha256":"3a93c2bfbb236e5bc41b7ab75a67ff56e7ad3535adc229518b45c2f9fd8707e3","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"77a67bb33dd434f0830de00fa224581bad015ec39cd638b503f2665f22047bf6","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"931fe9e6d50ef07c85699549278548e80ba4d7e263cadea409f6b2458fde45ca","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"f8be6f091eb5cb4e69ebec669d3b1addfda400fe705d0b4fd8d163d020a7e6f8","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/data/templates/tools/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"5b88d0ffb7f590e4b84bff487ebbf7b06d9aac8a4f640141f3d38992c41aafeb","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/core.py","source":"skill/scripts/core.py","ownership":"exact","sha256":"56019d529e82767f6dce8505945c55fc2253b596200b0e915fc89787a3bc4837","executable":true,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/http_checks.py","source":"skill/scripts/http_checks.py","ownership":"exact","sha256":"5620e187a0129f135621425a84b3a4e8f31137263c7e549a36a801fc36ff54ea","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/install_integrity.py","source":"skill/scripts/install_integrity.py","ownership":"exact","sha256":"20b0424152d61b3c067feb9558dd2532ab3abb459fc71a4c7de915e95bd83696","executable":false,"scope":"shared","version":"4.2.0"},{"path":".agents/skills/auto-coding-skill/scripts/scaffold_templates.py","source":"skill/scripts/scaffold_templates.py","ownership":"exact","sha256":"c825f15591b41403b7a97877c17f66cddcbbc5b029d143a7f1252e85388608e1","executable":false,"scope":"shared","version":"4.2.0"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"f8be6f091eb5cb4e69ebec669d3b1addfda400fe705d0b4fd8d163d020a7e6f8","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md#managed-workflow","ownership":"managed-workflow","sha256":"1f7b20eaba98d4fa7e5503e844831fbe36648cb54b4e89dfca1834b9d33df54e","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/architecture/adr/_TEMPLATE-ADR.md","source":"generated:scaffold_templates:docs/architecture/adr/_TEMPLATE-ADR.md","ownership":"exact","sha256":"88c89065ae0f8555412dbe096c05342152efc7becae8d8981e6442cdfee8e672","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/architecture/structure-standard.md","source":"generated:scaffold_templates:docs/architecture/structure-standard.md","ownership":"exact","sha256":"aa2e9bbf1baad0f3a3e0e97aaaefee7282740f09a976b1bb9be7fa0b529a549a","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md","source":"generated:scaffold_templates:docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md","ownership":"exact","sha256":"f2c17c0febc322b0ad50fb9d6f7e64e6c0cfb15c8a3e445a99da40f0a0dd1901","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/design/_TEMPLATE-DD.md","source":"generated:scaffold_templates:docs/design/_TEMPLATE-DD.md","ownership":"exact","sha256":"6ca022d127bfff68521f466b60bace4f1206baf0913daa855b9f751e74198db3","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/reviews/_TEMPLATE-REVIEW.md","source":"generated:scaffold_templates:docs/reviews/_TEMPLATE-REVIEW.md","ownership":"exact","sha256":"134f0d1bd3c7a317ef3cf4c2aea9f0539f3d53dccd5bcdabf6915b3629ef8802","executable":false,"scope":"project","version":"4.2.0"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.2.0"}],"managed_namespaces":[{"path":".agents/skills/auto-coding-skill","scope":"shared"},{"path":"docs/tools/autopipeline","scope":"project"}],"preserved":[".agents/archive/**",".agents/agents/* (except paths listed in entries)","docs/project/**","docs/architecture/adr/[0-9]*.md","docs/design/*.md","docs/interfaces/*.md","docs/deployment/deploy-records/*.md","docs/reviews/*.md"]}
|
|
@@ -7,8 +7,9 @@ description: Optional delivery-first engineering workflow for repository changes
|
|
|
7
7
|
|
|
8
8
|
## Use the two authorities
|
|
9
9
|
|
|
10
|
-
Read root `AGENTS.md` for the shared behavioral protocol
|
|
11
|
-
`docs/ENGINEERING.md` for
|
|
10
|
+
Read root `AGENTS.md` for the shared behavioral protocol,
|
|
11
|
+
`docs/ENGINEERING.md` for access/risk/validation configuration, and
|
|
12
|
+
`docs/project/` for durable project facts.
|
|
12
13
|
Do not reconstruct or duplicate those rules from historical task documents.
|
|
13
14
|
|
|
14
15
|
Normal delivery is:
|
|
@@ -38,6 +39,8 @@ fingerprinted review, or when the user explicitly requests it:
|
|
|
38
39
|
```bash
|
|
39
40
|
python3 docs/tools/autopipeline/ap.py task-start T0001 \
|
|
40
41
|
--owned-path src [--isolated] [--review-required] [--continue-direct --direct-claim <ID>]
|
|
42
|
+
# Before the first commit, expand an active task instead of restarting it:
|
|
43
|
+
python3 docs/tools/autopipeline/ap.py task-scope-add T0001 --owned-path config/new-scope
|
|
41
44
|
# For review-required work, obtain the current fingerprint and approve it:
|
|
42
45
|
python3 docs/tools/autopipeline/ap.py task-status T0001 --json
|
|
43
46
|
python3 docs/tools/autopipeline/ap.py task-review T0001 \
|
|
@@ -53,11 +56,17 @@ with `agent-contract-check`; parallel fixers require reclassification with `--wr
|
|
|
53
56
|
|
|
54
57
|
## Close with the bounded routed gate
|
|
55
58
|
|
|
59
|
+
For unregistered clean serial work, run the final gate and then use normal Git:
|
|
60
|
+
|
|
56
61
|
```bash
|
|
57
62
|
python3 docs/tools/autopipeline/ap.py validation-map-check --path <PATH>
|
|
58
63
|
python3 docs/tools/autopipeline/ap.py light-gate --scope changed --explain
|
|
59
64
|
```
|
|
60
65
|
|
|
66
|
+
For a registered task, call only `commit-push`: it owns the final gate and reuses
|
|
67
|
+
an exact Git-local PASS only while content, base, scope, routes, commands, and
|
|
68
|
+
lease match. Matching manual passes are reusable; changed state is not.
|
|
69
|
+
|
|
61
70
|
Every changed code/config path must map to a real project command. The runtime
|
|
62
71
|
de-duplicates commands and enforces route, command, and total budgets. Defaults
|
|
63
72
|
are 120 seconds per command and 180 total; projects may raise them for a measured
|
|
@@ -70,17 +79,20 @@ diagnosis continues in the same task without inventing another lifecycle.
|
|
|
70
79
|
|
|
71
80
|
## Keep state and upgrades safe
|
|
72
81
|
|
|
73
|
-
Machine task state, leases, fingerprints, and gate evidence stay
|
|
74
|
-
|
|
75
|
-
|
|
82
|
+
Machine task state, leases, fingerprints, and gate evidence stay Git-local.
|
|
83
|
+
Ordinary work creates no taskbook, closure, evidence JSONL, active-task, or
|
|
84
|
+
design artifact. Terminal ledger reconciliation validates and commits once.
|
|
76
85
|
|
|
77
86
|
```bash
|
|
78
87
|
autocoding init
|
|
79
|
-
autocoding sync --projects .
|
|
80
|
-
python3 docs/tools/autopipeline/ap.py upgrade --dry-run
|
|
81
|
-
python3 docs/tools/autopipeline/ap.py upgrade --write
|
|
82
88
|
python3 docs/tools/autopipeline/ap.py doctor
|
|
83
89
|
```
|
|
84
90
|
|
|
85
|
-
Finish registered tasks before changing versions.
|
|
86
|
-
|
|
91
|
+
Finish registered tasks before changing versions. `autocoding init` is idempotent
|
|
92
|
+
and performs the complete install/upgrade: it replaces every managed constraint,
|
|
93
|
+
preserves only schema-supported project values, installs the canonical docs
|
|
94
|
+
directory framework and managed templates, and archives obsolete content outside
|
|
95
|
+
active `docs/` while preserving valid architecture, ADR, interface, DD, review,
|
|
96
|
+
and deploy-record artifacts in their designated directories. It then verifies the
|
|
97
|
+
packaged managed-install manifest; `doctor` cheaply rechecks the same declared
|
|
98
|
+
paths without treating project-owned files or archives as a release mirror.
|
|
@@ -1,15 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
workflow:
|
|
3
|
-
skill_version: "4.
|
|
3
|
+
skill_version: "4.2.0"
|
|
4
4
|
mode: "dev"
|
|
5
5
|
profile: "auto"
|
|
6
6
|
completion: "push"
|
|
7
|
-
|
|
8
7
|
project:
|
|
9
8
|
name: ""
|
|
10
9
|
repo_root: "."
|
|
11
10
|
stack: "generic"
|
|
12
|
-
|
|
13
11
|
access:
|
|
14
12
|
project:
|
|
15
13
|
frontend:
|
|
@@ -38,7 +36,6 @@ access:
|
|
|
38
36
|
url: ""
|
|
39
37
|
username: ""
|
|
40
38
|
password: ""
|
|
41
|
-
|
|
42
39
|
concurrency:
|
|
43
40
|
isolation: "adaptive"
|
|
44
41
|
base_ref: ""
|
|
@@ -48,12 +45,10 @@ concurrency:
|
|
|
48
45
|
cleanup_merged: true
|
|
49
46
|
delete_remote_branch: true
|
|
50
47
|
disposable_ignored: []
|
|
51
|
-
|
|
52
48
|
commands:
|
|
53
49
|
# Optional convenience command. Define the project-native fast commands used
|
|
54
50
|
# by validation.routes; sync fills this only for package.json test:changed.
|
|
55
51
|
project_fast: ""
|
|
56
|
-
|
|
57
52
|
validation:
|
|
58
53
|
on_unmapped: "error"
|
|
59
54
|
# Recommended fast defaults. Raise only for a measured affected-scope check;
|
|
@@ -63,10 +58,8 @@ validation:
|
|
|
63
58
|
# Initialization must replace this with real path-to-command mappings. Empty
|
|
64
59
|
# routes intentionally fail closed for code/config changes.
|
|
65
60
|
routes: []
|
|
66
|
-
|
|
67
61
|
risk:
|
|
68
62
|
rules: []
|
|
69
|
-
|
|
70
63
|
structure:
|
|
71
64
|
enabled: true
|
|
72
65
|
enforcement: "advisory"
|
|
@@ -75,33 +68,25 @@ structure:
|
|
|
75
68
|
layer_rules:
|
|
76
69
|
enabled: true
|
|
77
70
|
block: false
|
|
78
|
-
|
|
71
|
+
rules: []
|
|
79
72
|
optimization:
|
|
80
73
|
completion_policy: "no-new-debt"
|
|
81
74
|
require_baseline_for_global_review: false
|
|
82
75
|
report_accepted_debt_as_findings: false
|
|
83
|
-
|
|
84
76
|
docs:
|
|
85
77
|
framework: "engineering-centered"
|
|
86
78
|
design_dir: "docs/design"
|
|
87
|
-
health_baseline: "docs/reviews/project-health-baseline.md"
|
|
88
|
-
optimization_backlog: "docs/reviews/optimization-backlog.md"
|
|
89
79
|
structure_standard: "docs/architecture/structure-standard.md"
|
|
90
80
|
api_docs_required: false
|
|
91
81
|
api_doc: "docs/interfaces/api.md"
|
|
92
82
|
api_change_log: "docs/interfaces/api-change-log.md"
|
|
93
83
|
---
|
|
94
|
-
|
|
95
84
|
# Engineering Configuration and Project Facts
|
|
96
|
-
|
|
97
|
-
<!-- auto-coding-skill:managed-workflow:start version=4.1.7 -->
|
|
98
|
-
|
|
85
|
+
<!-- auto-coding-skill:managed-workflow:start version=4.2.0 -->
|
|
99
86
|
Root `AGENTS.md` is the single shared behavioral protocol. The installed
|
|
100
|
-
`SKILL.md` contains invocation guidance. This file is the
|
|
101
|
-
project
|
|
102
|
-
|
|
87
|
+
`SKILL.md` contains invocation guidance. This file is the exact-schema source for
|
|
88
|
+
project workflow configuration and access values that neither file can infer.
|
|
103
89
|
The frontmatter contract is:
|
|
104
|
-
|
|
105
90
|
- `workflow`: installed version and push-completion mode.
|
|
106
91
|
- `access`: required project, Jenkins, GitLab, and Nexus access values.
|
|
107
92
|
- `concurrency`: target branch and adaptive isolation settings.
|
|
@@ -112,25 +97,13 @@ The frontmatter contract is:
|
|
|
112
97
|
- `risk`: project-specific signals that increase design/review depth but never
|
|
113
98
|
expand the automatic local gate.
|
|
114
99
|
- `structure` and `optimization`: advisory architecture and no-new-debt policy.
|
|
115
|
-
- `docs`: locations
|
|
116
|
-
|
|
117
|
-
|
|
100
|
+
- `docs`: locations inside the managed documentation directory framework.
|
|
101
|
+
Run `python3 docs/tools/autopipeline/ap.py doctor` after changing frontmatter; it
|
|
102
|
+
also performs the bounded local managed-install integrity check.
|
|
118
103
|
Do not put competing delivery flows, agent roles, lifecycle rules, gate semantics,
|
|
119
104
|
or completion rules outside this managed block.
|
|
120
|
-
|
|
121
105
|
<!-- auto-coding-skill:managed-workflow:end -->
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
`docs/project/` and link it from the relevant section.
|
|
127
|
-
|
|
128
|
-
## Product and domain boundaries
|
|
129
|
-
|
|
130
|
-
## Repository and ownership map
|
|
131
|
-
|
|
132
|
-
## Runtime and deployment topology
|
|
133
|
-
|
|
134
|
-
## External-system and real-device safety
|
|
135
|
-
|
|
136
|
-
## Interface and decision links
|
|
106
|
+
# Project Facts Location
|
|
107
|
+
Keep durable project facts in the installed `docs/project/` files. Do not append
|
|
108
|
+
workflow rules or additional sections here; initialization owns this document's
|
|
109
|
+
schema and body.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- auto-coding-skill:managed-agents:start version=4.
|
|
1
|
+
<!-- auto-coding-skill:managed-agents:start version=4.2.0 -->
|
|
2
2
|
# Shared Engineering Protocol
|
|
3
3
|
|
|
4
4
|
This file is fully managed by `auto-coding-skill`. Keep project-specific facts,
|
|
@@ -11,7 +11,8 @@ Use this order when sources disagree:
|
|
|
11
11
|
1. The current user request.
|
|
12
12
|
2. Code, tests, schemas, migrations, and runtime configuration for behavior that
|
|
13
13
|
exists now.
|
|
14
|
-
3. `docs/ENGINEERING.md` for
|
|
14
|
+
3. `docs/ENGINEERING.md` for workflow configuration and access values, then the
|
|
15
|
+
managed `docs/project/` files for durable project facts.
|
|
15
16
|
4. Current interface documentation for intended contracts.
|
|
16
17
|
5. Accepted DD/ADR for lasting decisions.
|
|
17
18
|
6. Taskbooks, closures, reviews, and deployment records as history only.
|
|
@@ -57,6 +58,10 @@ failure may continue in the same conversation/task without a second lifecycle.
|
|
|
57
58
|
requires a registered task branch/worktree.
|
|
58
59
|
- Every delegated fixer or parallel writer owns a task ID/worktree, writer lease,
|
|
59
60
|
non-overlapping `owned_paths`, and prerequisite commit SHAs.
|
|
61
|
+
- Before its first commit, an active task may add explicit paths with
|
|
62
|
+
`task-scope-add`; the command checks leases/conflicts, only raises risk, and
|
|
63
|
+
invalidates prior review and final-gate state. Never restart a no-diff task just
|
|
64
|
+
to enlarge its declared scope.
|
|
60
65
|
- Never let multiple writing agents share a checkout. Never restore, reset, stash,
|
|
61
66
|
clean, overwrite, or commit unknown changes.
|
|
62
67
|
- No diff means no commit, push, or temporary branch.
|
|
@@ -94,6 +99,10 @@ failure may continue in the same conversation/task without a second lifecycle.
|
|
|
94
99
|
validation.
|
|
95
100
|
- Focused tests may run and rerun during development. Run one final routed gate
|
|
96
101
|
after the diff is stable.
|
|
102
|
+
- For registered tasks, `commit-push` owns that final gate; do not run a separate
|
|
103
|
+
`light-gate` first. A strict Git-local PASS receipt may be reused only while the
|
|
104
|
+
content/index, base, scope, route/command plan, and writer lease still match.
|
|
105
|
+
Unregistered clean serial work runs `light-gate` before normal Git closure.
|
|
97
106
|
- The final gate defaults to 120 seconds per command and 180 seconds total. A
|
|
98
107
|
project may raise either budget for a measured affected-scope check, and may set
|
|
99
108
|
a smaller `timeout_seconds` on an individual route. A timeout should narrow the
|
|
@@ -110,10 +119,15 @@ failure may continue in the same conversation/task without a second lifecycle.
|
|
|
110
119
|
## Documentation and access
|
|
111
120
|
|
|
112
121
|
- This AGENTS file is the single behavioral protocol. The installed `SKILL.md`
|
|
113
|
-
contains invocation guidance. `docs/ENGINEERING.md` is the
|
|
114
|
-
configuration
|
|
115
|
-
|
|
116
|
-
|
|
122
|
+
contains invocation guidance. `docs/ENGINEERING.md` is the exact project
|
|
123
|
+
configuration source; `docs/project/` owns durable facts. Do not repeat the
|
|
124
|
+
protocol elsewhere.
|
|
125
|
+
- `autocoding init` owns the active `docs/` directory topology and managed
|
|
126
|
+
templates. Put durable facts into the installed project files. Architecture,
|
|
127
|
+
ADR, interface, DD, review, and deploy-record artifacts may use their designated
|
|
128
|
+
directories; unrelated directories are archived outside active docs on upgrade.
|
|
129
|
+
- The managed-install manifest owns only its declared files and exact namespaces.
|
|
130
|
+
Never treat the whole `.agents` or `docs` tree as a release-package mirror.
|
|
117
131
|
- Ordinary work creates no taskbook, closure Markdown, evidence JSONL, active-task
|
|
118
132
|
document, or design file. Machine coordination/evidence stays in Git
|
|
119
133
|
common/local state and cannot change the reviewed diff.
|