@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 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.1.7 makes the Python runtime check, release verification, and tag
13
- publication environment reproducible while removing the unnecessary `requests`
14
- dependency. Version 4.1.4
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
- Ordinary projects no longer receive taskbook or closure logs. Existing optional
45
- documents are preserved during upgrades but are not required or updated by the
46
- normal workflow.
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
- When a direct task materially changes scope after writing, reclassify with
89
- `--continue-direct` and repeat every current task `--planned-path`. Undeclared
90
- dirty paths, another writer, or mandatory isolation still selects a worktree. If
91
- the new plan requires review lifecycle, reuse `--continue-direct` on `task-start`.
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 and multi-project sync
208
+ ## Upgrade projects
198
209
 
199
- Finish every registered task using its currently installed runtime before syncing
200
- a different Skill version. Batch sync fails before any writes when it finds an
201
- active manifest, regardless of schema version.
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
- Sync replaces the managed Skill directory, so missing files are restored and
210
- obsolete managed files are removed. It preserves project frontmatter, access
211
- values, custom role agents, explicit model overrides, optional documents, and
212
- project-specific facts outside the managed ENGINEERING block. Root `AGENTS.md` is
213
- replaced as a whole; its previous content is archived under
214
- `docs/archive/workflow/` as historical, non-authoritative context.
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 and
11
- `docs/ENGINEERING.md` for project facts, access, risk, validation, and budgets.
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 in Git local
74
- state. Ordinary work creates no taskbook, closure, evidence JSONL, active-task,
75
- or design artifact. Terminal ledger reconciliation validates and commits once.
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. Sync replaces root `AGENTS.md`,
86
- archives it, preserves project facts/access, and converges all managed assets.
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,8 +1,8 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "managed_versions": {
4
- "agents": "4.1.7",
5
- "engineering": "4.1.7"
4
+ "agents": "4.2.0",
5
+ "engineering": "4.2.0"
6
6
  },
7
7
  "known_official_agents_sha256": [
8
8
  "ebaaadab60327b3a4852948443d7191a4d48cb00bf4910038ab78c9149089373"
@@ -1,15 +1,13 @@
1
1
  ---
2
2
  workflow:
3
- skill_version: "4.1.7"
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 single source for the
101
- project-specific configuration and facts that neither file can infer.
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 of optional durable project artifacts.
116
-
117
- Run `python3 docs/tools/autopipeline/ap.py doctor` after changing frontmatter.
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
- # Project Facts
124
-
125
- Keep only current, project-specific facts here. Put larger material under
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.7 -->
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 project facts and workflow configuration.
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 single project
114
- configuration and facts source. Do not repeat the protocol elsewhere.
115
- - Put larger product, repository, and runtime facts under `docs/project/` and link
116
- them from ENGINEERING.
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.