@elvis1513/auto-coding-skill 4.2.8 → 4.3.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,6 +9,10 @@ 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.3.0 separates exact managed defaults from a byte-stable project
13
+ configuration overlay, migrates legacy specialization with semantic proof, and
14
+ adds project-owned shared-Skill feedback inboxes with bounded read-only
15
+ multi-project triage. Upgrades now use recoverable, owner-bound transactions.
12
16
  Version 4.2.8 makes the supervised Reviewer observable and recoverable without
13
17
  weakening review semantics: it streams private event metadata, distinguishes
14
18
  startup failure from analysis timeout, retries one no-event startup, and supports
@@ -63,20 +67,70 @@ The project install contains:
63
67
  .agents/skills/auto-coding-skill/
64
68
  .agents/agents/
65
69
  docs/ENGINEERING.md
70
+ docs/project/auto-coding-skill.yaml
66
71
  docs/tools/autopipeline/ap.py
67
72
  AGENTS.md (fully managed canonical repository contract)
68
73
  ```
69
74
 
70
75
  `autocoding init` also installs the exact shared documentation tree under
71
- `docs/{architecture,bugs,deployment,design,interfaces,project,reviews,testing}`.
76
+ `docs/{architecture,bugs,deployment,design,interfaces,project,reviews,skill-feedback,testing}`.
72
77
  Managed templates are replaced; the scaffolded project structure standard,
73
78
  mutable project docs, and valid architecture, ADR, interface, DD, review, or
74
- deploy-record documents are preserved; unrelated
79
+ deploy-record documents plus `docs/skill-feedback/reports/*.md` are preserved;
80
+ unrelated
75
81
  directories are archived under `.agents/archive/`. Re-running init is the complete upgrade operation;
76
- `sync` and project-local `upgrade` are compatibility commands, not required steps.
82
+ `sync` is the explicit multi-project equivalent. Project-local
83
+ `ap.py upgrade --dry-run` remains a read-only legacy diagnostic; its old write
84
+ mode is retired so upgrades cannot bypass the transactional installer.
85
+ Multi-project sync completes all read-only preflights before its first write;
86
+ after that boundary, each project has its own recoverable transaction, so a
87
+ later host I/O failure does not roll back projects that already completed.
88
+
89
+ `docs/ENGINEERING.md` is the exact managed default layer. Project-specific
90
+ access, commands, validation routes, risk rules, structure policy, and other
91
+ supported values belong in `docs/project/auto-coding-skill.yaml`. Runtime commands
92
+ recursively overlay project mappings on managed defaults; project scalar and list
93
+ values replace defaults, while code-enforced safety invariants remain mandatory.
94
+ Ordinary init, sync, and upgrade operations never rewrite an existing overlay.
95
+ The first compatible upgrade extracts the semantic difference from the previous
96
+ managed default, verifies equivalence, and creates the overlay before replacing
97
+ managed files.
98
+
99
+ ## Shared Skill feedback
100
+
101
+ Every initialized project receives:
77
102
 
78
- Fill the project/Jenkins/GitLab/Nexus URL, username, and password fields under
79
- `access.*`, then configure one real fast validation command and run:
103
+ ```text
104
+ docs/skill-feedback/
105
+ ├── README.md
106
+ ├── _TEMPLATE-SKILL-FEEDBACK.md
107
+ └── reports/ # created when the first report is added
108
+ └── YYYY-MM-DD-<slug>-<8-hex>.md
109
+ ```
110
+
111
+ The README and template are managed; reports are project-owned and upgrades
112
+ preserve them byte-for-byte. A report is a candidate observation only. Create one
113
+ after distinguishing managed Skill behavior from project `risk.rules`, validation
114
+ routes, access values, structure policy, business code, and environment failures.
115
+ Do not automatically turn test failures or Reviewer findings into reports, and do
116
+ not include credentials, customer/device data, complete patches, Reviewer
117
+ artifacts, raw logs, or absolute user paths.
118
+
119
+ Periodic triage is explicit and read-only:
120
+
121
+ ```bash
122
+ autocoding feedback --projects /path/geestock,/path/geesight,/path/xjmate --json
123
+ ```
124
+
125
+ The collector scans only bounded report metadata from the listed projects,
126
+ executes nothing from the documents, changes no repository, and groups exact
127
+ root-cause signatures. Human triage still decides whether an observation is a
128
+ shared defect, project configuration, environment issue, duplicate, or missing
129
+ evidence before fixes and a release are planned.
130
+
131
+ Fill the project/Jenkins/GitLab/Nexus URL, username, and password overrides under
132
+ `access.*` in `docs/project/auto-coding-skill.yaml`, then configure one real fast
133
+ validation command and run:
80
134
 
81
135
  ```bash
82
136
  python3 docs/tools/autopipeline/ap.py doctor
@@ -320,6 +374,29 @@ model overrides, complete project `risk.rules`, supported project/access/
320
374
  concurrency/route/structure values, and an existing project-owned structure
321
375
  standard byte-for-byte. Removed content is archived outside active docs.
322
376
 
377
+ ## What changed in 4.3.0
378
+
379
+ - Made `docs/ENGINEERING.md` the exact managed default layer and added
380
+ `docs/project/auto-coding-skill.yaml` as the higher-priority project-owned
381
+ overlay. Mappings merge recursively; explicit project scalars and lists replace
382
+ defaults, while managed workflow identity and code-enforced safety invariants
383
+ remain protected.
384
+ - Added one-time semantic migration from the previous manifest-bound default.
385
+ Initialization creates the overlay without overwriting an existing one, proves
386
+ the reconstructed effective configuration is equivalent, archives the legacy
387
+ document, and then converges the managed default byte-for-byte.
388
+ - Added `docs/skill-feedback/` with managed guidance/template and preserved
389
+ project-owned reports. `autocoding feedback --projects ... --json` performs an
390
+ explicit bounded metadata-only read and groups exact root-cause signatures for
391
+ later human triage.
392
+ - Replaced partial upgrade writes with owner-bound, recoverable installation
393
+ transactions, staged/installed hash checks, active-installer rejection, safe
394
+ project-file operations, and fail-closed effective-configuration validation.
395
+ Project-local `ap.py upgrade --write` is retired in favor of transactional
396
+ `autocoding init` or explicit multi-project `sync`.
397
+ - Batched protected executable-mode convergence so the safer installer retains
398
+ practical upgrade latency while preserving symlink/reparse checks.
399
+
323
400
  ## What changed in 4.2.8
324
401
 
325
402
  - Replaced end-only Reviewer output collection with bounded JSONL event streaming.
@@ -1 +1 @@
1
- {"schema_version":1,"skill_version":"4.2.8","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.8"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"e1ad676e608ffee04d782571fb9bfbc787f69c100941b1811d955ef80439db36","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"b573dcb66a1d3d084a413c8cec32d701f3dc07aec956336315a400e54b54b342","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json","source":"skill/data/contracts/orchestration-v1.schema.json","ownership":"exact","sha256":"65a8c0d222b26f224794ec106101f903f0e3a357b249c2df22c5908a476a6835","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"5912f6c1807f90fa2f6e8984eb0dd2465c4c55667d0bd7f915dab2fa795ce3b2","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"750407c5ed571d799e759389dc7c954319e93b07529e4f0fe97b4113a6b285a4","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"84ffa96cbafe5c70f984d65af0e292249893bde5fb0faec0fec606282bed6a79","executable":false,"scope":"shared","version":"4.2.8"},{"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.8"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"e5456e17ceaf51e47b90203a7b4331dd7a8eef21126627b385228897b34d03ae","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/scripts/core.py","source":"skill/scripts/core.py","ownership":"exact","sha256":"640c37e8b274d90d6b7765d4243e054360d5a5a85b3150fbfe6449527c1cd28f","executable":true,"scope":"shared","version":"4.2.8"},{"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.8"},{"path":".agents/skills/auto-coding-skill/scripts/install_integrity.py","source":"skill/scripts/install_integrity.py","ownership":"exact","sha256":"a9ca7bd67893bbd2d7b35ece30a40457f0cbcb9ae01580cfc5daca2cd96fd676","executable":false,"scope":"shared","version":"4.2.8"},{"path":".agents/skills/auto-coding-skill/scripts/scaffold_templates.py","source":"skill/scripts/scaffold_templates.py","ownership":"exact","sha256":"6f0ee92eff2d5db9627a64b332738c9c917a93cc559d5bbacf771c5966215821","executable":false,"scope":"shared","version":"4.2.8"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"84ffa96cbafe5c70f984d65af0e292249893bde5fb0faec0fec606282bed6a79","executable":false,"scope":"project","version":"4.2.8"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md#managed-workflow","ownership":"managed-workflow","sha256":"bac3eeed72e3654fe8ec3f2c79e5fcabb968ee6374fa4971bbf041969455bc4d","executable":false,"scope":"project","version":"4.2.8"},{"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.8"},{"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.8"},{"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.8"},{"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.8"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.2.8"}],"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/structure-standard.md","docs/architecture/adr/[0-9]*.md","docs/design/*.md","docs/interfaces/*.md","docs/deployment/deploy-records/*.md","docs/reviews/*.md"]}
1
+ {"schema_version":1,"skill_version":"4.3.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.3.0"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"e1ad676e608ffee04d782571fb9bfbc787f69c100941b1811d955ef80439db36","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"d142951aa5cd7062ec467421654c7cda0a9dac2262eedc97a92590428b3a21e7","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json","source":"skill/data/contracts/orchestration-v1.schema.json","ownership":"exact","sha256":"65a8c0d222b26f224794ec106101f903f0e3a357b249c2df22c5908a476a6835","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"b3d1018ad1778045cd6b329a2591576f8ab4e3ec4ff9b01036ffaeb327ecc8db","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"c31b61084a4a20d95f2b5a6168efce596e9487d4b47d1f979cc4da915b13928d","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"2c21fd3ecfd34334aeadf203247150e2ec0abfa7f11ec0cb4f94bfe95d6a4d73","executable":false,"scope":"shared","version":"4.3.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.3.0"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"e893422f616017c825b2ec3e109ee5fbe96c6262c9ada31f9e92663d23408008","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/scripts/core.py","source":"skill/scripts/core.py","ownership":"exact","sha256":"caefca925929bad840c3471b86332d4be48b5e19ad0ff79fde1dcedef0297c16","executable":true,"scope":"shared","version":"4.3.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.3.0"},{"path":".agents/skills/auto-coding-skill/scripts/install_integrity.py","source":"skill/scripts/install_integrity.py","ownership":"exact","sha256":"44eb23b2bfbfc854be9c23e5ff7a4f133a32365316af976844ed129a3a69d2e3","executable":false,"scope":"shared","version":"4.3.0"},{"path":".agents/skills/auto-coding-skill/scripts/scaffold_templates.py","source":"skill/scripts/scaffold_templates.py","ownership":"exact","sha256":"ff1fe25c65da0f93baf84f358d1117ae038f16e996a443b73cc06d11699aa36d","executable":false,"scope":"shared","version":"4.3.0"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"2c21fd3ecfd34334aeadf203247150e2ec0abfa7f11ec0cb4f94bfe95d6a4d73","executable":false,"scope":"project","version":"4.3.0"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"c31b61084a4a20d95f2b5a6168efce596e9487d4b47d1f979cc4da915b13928d","executable":false,"scope":"project","version":"4.3.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.3.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.3.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.3.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.3.0"},{"path":"docs/skill-feedback/README.md","source":"generated:scaffold_templates:docs/skill-feedback/README.md","ownership":"exact","sha256":"7beea4818091cef49fd41022e4f423adf1c917525d694d137eb807ba69d2f920","executable":false,"scope":"project","version":"4.3.0"},{"path":"docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md","source":"generated:scaffold_templates:docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md","ownership":"exact","sha256":"d72a65d922c8b0609050e68d509b983eb18841c71b53dd5db4d9b75b36750785","executable":false,"scope":"project","version":"4.3.0"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.3.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/project/auto-coding-skill.yaml","docs/architecture/structure-standard.md","docs/architecture/adr/[0-9]*.md","docs/design/*.md","docs/interfaces/*.md","docs/deployment/deploy-records/*.md","docs/reviews/*.md","docs/skill-feedback/reports/*.md"]}
@@ -7,9 +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 access/risk/validation configuration, and
12
- `docs/project/` for durable project facts.
10
+ Read root `AGENTS.md` for the shared behavioral protocol, the effective
11
+ configuration formed from managed `docs/ENGINEERING.md` defaults plus
12
+ `docs/project/auto-coding-skill.yaml`, and `docs/project/` for durable facts.
13
13
  Do not reconstruct or duplicate those rules from historical task documents.
14
14
 
15
15
  Normal delivery is:
@@ -94,7 +94,7 @@ python3 docs/tools/autopipeline/ap.py doctor
94
94
  ```
95
95
 
96
96
  Finish registered tasks before changing versions. `autocoding init` idempotently
97
- replaces managed constraints, preserves schema-supported values, installs canonical
98
- docs/templates, archives obsolete content outside active `docs/`, and preserves
99
- designated artifacts. It verifies the managed-install manifest; `doctor` cheaply
100
- rechecks declared paths without treating project-owned files or archives as a mirror.
97
+ replaces managed defaults and constraints while preserving the project overlay
98
+ byte-for-byte after its one-time semantic migration. It installs canonical docs,
99
+ archives obsolete content outside active `docs/`, verifies the managed-install
100
+ manifest, and lets `doctor` validate the effective configuration.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "managed_versions": {
4
- "agents": "4.2.8",
5
- "engineering": "4.2.8"
4
+ "agents": "4.3.0",
5
+ "engineering": "4.3.0"
6
6
  },
7
7
  "known_official_agents_sha256": [
8
8
  "ebaaadab60327b3a4852948443d7191a4d48cb00bf4910038ab78c9149089373"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  workflow:
3
- skill_version: "4.2.8"
3
+ skill_version: "4.3.0"
4
4
  mode: "dev"
5
5
  profile: "auto"
6
6
  completion: "push"
@@ -83,10 +83,12 @@ docs:
83
83
  api_change_log: "docs/interfaces/api-change-log.md"
84
84
  ---
85
85
  # Engineering Configuration and Project Facts
86
- <!-- auto-coding-skill:managed-workflow:start version=4.2.8 -->
86
+ <!-- auto-coding-skill:managed-workflow:start version=4.3.0 -->
87
87
  Root `AGENTS.md` is the single shared behavioral protocol. The installed
88
- `SKILL.md` contains invocation guidance. This file is the exact-schema source for
89
- project workflow configuration and access values that neither file can infer.
88
+ `SKILL.md` contains invocation guidance. This whole file is the managed default
89
+ configuration contract. Project-owned values live only in
90
+ `docs/project/auto-coding-skill.yaml`; the runtime overlays that file on these
91
+ defaults without allowing it to weaken code-enforced safety invariants.
90
92
  The frontmatter contract is:
91
93
  - `workflow`: installed version and push-completion mode.
92
94
  - `access`: required project, Jenkins, GitLab, and Nexus access values.
@@ -95,16 +97,19 @@ The frontmatter contract is:
95
97
  - `validation`: explicit path-to-command routes plus the bounded final-gate time
96
98
  budget. Code/config paths must be mapped; route-level `timeout_seconds` can
97
99
  bound a slower command; commands inherit PATH and declare intentional activation.
98
- - `risk`: project-specific signals that increase design/review depth but never
99
- expand the automatic local gate.
100
- - `structure` and `optimization`: project-selected enforcement and completion policy; frontmatter values are authoritative.
100
+ - `risk`: default signals that project-specific rules may replace in the
101
+ project overlay; code-enforced high-risk classifications remain mandatory.
102
+ - `structure` and `optimization`: managed defaults that the project overlay may
103
+ replace explicitly.
101
104
  - `docs`: locations inside the managed documentation directory framework.
102
105
  Run `python3 docs/tools/autopipeline/ap.py doctor` after changing frontmatter; it
103
106
  also performs the bounded local managed-install integrity check.
104
- Do not put competing delivery flows, agent roles, lifecycle rules, gate semantics,
105
- or completion rules outside this managed block.
107
+ Do not edit this file for project specialization. Run
108
+ `python3 docs/tools/autopipeline/ap.py config-effective --json` to inspect the
109
+ redacted effective configuration, and edit only the project overlay. Do not put
110
+ competing delivery flows, agent roles, lifecycle rules, gate semantics, or
111
+ completion rules outside this managed block.
106
112
  <!-- auto-coding-skill:managed-workflow:end -->
107
113
  # Project Facts Location
108
- Keep durable project facts in the installed `docs/project/` files. Do not append
109
- workflow rules or additional sections here; initialization owns this document's
110
- schema and body.
114
+ Keep durable project facts in the installed `docs/project/` files. Initialization
115
+ owns this document byte-for-byte and never rewrites an existing project overlay.
@@ -1,8 +1,8 @@
1
- <!-- auto-coding-skill:managed-agents:start version=4.2.8 -->
1
+ <!-- auto-coding-skill:managed-agents:start version=4.3.0 -->
2
2
  # Shared Engineering Protocol
3
3
 
4
- This file is fully managed by `auto-coding-skill`. Keep project-specific facts,
5
- access values, risk rules, and validation routes in `docs/ENGINEERING.md`.
4
+ This file is fully managed by `auto-coding-skill`. Keep project-specific facts in
5
+ `docs/project/` and configuration in `docs/project/auto-coding-skill.yaml`.
6
6
 
7
7
  ## Authority
8
8
 
@@ -11,8 +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 workflow configuration and access values, then the
15
- managed `docs/project/` files for durable project facts.
14
+ 3. The effective configuration formed from managed `docs/ENGINEERING.md` defaults
15
+ plus the project overlay, then `docs/project/` for durable project facts.
16
16
  4. Current interface documentation for intended contracts.
17
17
  5. Accepted DD/ADR for lasting decisions.
18
18
  6. Taskbooks, closures, reviews, and deployment records as history only.
@@ -124,9 +124,9 @@ failure may continue in the same conversation/task without a second lifecycle.
124
124
  ## Documentation and access
125
125
 
126
126
  - This AGENTS file is the single behavioral protocol. The installed `SKILL.md`
127
- contains invocation guidance. `docs/ENGINEERING.md` is the exact project
128
- configuration source; `docs/project/` owns durable facts. Do not repeat the
129
- protocol elsewhere.
127
+ contains invocation guidance. `docs/ENGINEERING.md` is managed default policy;
128
+ `docs/project/auto-coding-skill.yaml` is the higher-priority project overlay,
129
+ and the remaining `docs/project/` files own durable facts.
130
130
  - `autocoding init` owns the active `docs/` directory topology and managed
131
131
  templates. Put durable facts into the installed project files. Architecture,
132
132
  ADR, interface, DD, review, and deploy-record artifacts may use their designated
@@ -136,6 +136,10 @@ failure may continue in the same conversation/task without a second lifecycle.
136
136
  - Ordinary work creates no taskbook, closure Markdown, evidence JSONL, active-task
137
137
  document, or design file. Machine coordination/evidence stays in Git
138
138
  common/local state and cannot change the reviewed diff.
139
+ - After diagnosing the project/Skill boundary, record a probable shared-Skill
140
+ defect or gap from `docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md`; keep
141
+ project-only configuration out, redact sensitive/raw evidence, and never mutate
142
+ a frozen Reviewer diff merely to add feedback.
139
143
  - Pure ledger/archive reconciliation is terminal: validate, commit once, and stop.
140
144
  - Fill configured project/Jenkins/GitLab/Nexus access fields during initialization.
141
145
  Plaintext values are allowed; do not invent or unnecessarily echo credentials.