@elvis1513/auto-coding-skill 4.2.8 → 4.3.1

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,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.3.1 preserves recursively nested project documentation assets of any
13
+ file type, and gives project-owned Skill feedback a release-aware lifecycle with
14
+ active/closed grouping, recheck and verification notices, and explicit routing
15
+ of project preferences into the project overlay. Version 4.3.0 separates exact managed defaults from a byte-stable project
16
+ configuration overlay, migrates legacy specialization with semantic proof, and
17
+ adds project-owned shared-Skill feedback inboxes with bounded read-only
18
+ multi-project triage. Upgrades now use recoverable, owner-bound transactions.
12
19
  Version 4.2.8 makes the supervised Reviewer observable and recoverable without
13
20
  weakening review semantics: it streams private event metadata, distinguishes
14
21
  startup failure from analysis timeout, retries one no-event startup, and supports
@@ -63,20 +70,79 @@ The project install contains:
63
70
  .agents/skills/auto-coding-skill/
64
71
  .agents/agents/
65
72
  docs/ENGINEERING.md
73
+ docs/project/auto-coding-skill.yaml
66
74
  docs/tools/autopipeline/ap.py
67
75
  AGENTS.md (fully managed canonical repository contract)
68
76
  ```
69
77
 
70
78
  `autocoding init` also installs the exact shared documentation tree under
71
- `docs/{architecture,bugs,deployment,design,interfaces,project,reviews,testing}`.
72
- Managed templates are replaced; the scaffolded project structure standard,
73
- mutable project docs, and valid architecture, ADR, interface, DD, review, or
74
- deploy-record documents are preserved; unrelated
79
+ `docs/{architecture,bugs,deployment,design,interfaces,project,reviews,skill-feedback,testing}`.
80
+ Managed templates are replaced; project-owned files under the designated
81
+ architecture, bugs, deployment, design, interfaces, project, reviews, and testing
82
+ roots are preserved recursively and byte-for-byte regardless of extension, as
83
+ are `docs/skill-feedback/reports/*.md`;
84
+ unrelated
75
85
  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.
86
+ `sync` is the explicit multi-project equivalent. Project-local
87
+ `ap.py upgrade --dry-run` remains a read-only legacy diagnostic; its old write
88
+ mode is retired so upgrades cannot bypass the transactional installer.
89
+ Multi-project sync completes all read-only preflights before its first write;
90
+ after that boundary, each project has its own recoverable transaction, so a
91
+ later host I/O failure does not roll back projects that already completed.
92
+
93
+ `docs/ENGINEERING.md` is the exact managed default layer. Project-specific
94
+ access, commands, validation routes, risk rules, structure policy, and other
95
+ supported values belong in `docs/project/auto-coding-skill.yaml`. Runtime commands
96
+ recursively overlay project mappings on managed defaults; project scalar and list
97
+ values replace defaults, while code-enforced safety invariants remain mandatory.
98
+ Ordinary init, sync, and upgrade operations never rewrite an existing overlay.
99
+ The first compatible upgrade extracts the semantic difference from the previous
100
+ managed default, verifies equivalence, and creates the overlay before replacing
101
+ managed files.
102
+
103
+ ## Shared Skill feedback
104
+
105
+ Every initialized project receives:
77
106
 
78
- Fill the project/Jenkins/GitLab/Nexus URL, username, and password fields under
79
- `access.*`, then configure one real fast validation command and run:
107
+ ```text
108
+ docs/skill-feedback/
109
+ ├── README.md
110
+ ├── _TEMPLATE-SKILL-FEEDBACK.md
111
+ └── reports/ # created when the first report is added
112
+ └── YYYY-MM-DD-<slug>-<8-hex>.md
113
+ ```
114
+
115
+ The README and template are managed; reports are project-owned and upgrades
116
+ preserve them byte-for-byte. Releases carry a signature-keyed resolution catalog;
117
+ the read-only collector derives upgrade, recheck, verification, closure, and
118
+ project-overlay routing actions without rewriting reports. Closed reports are
119
+ excluded from active cross-project grouping. A report is a candidate observation only. Create one
120
+ after distinguishing managed Skill behavior from project `risk.rules`, validation
121
+ routes, access values, structure policy, business code, and environment failures.
122
+ Do not automatically turn test failures or Reviewer findings into reports, and do
123
+ not include credentials, customer/device data, complete patches, Reviewer
124
+ artifacts, raw logs, or absolute user paths.
125
+
126
+ Periodic triage is explicit and read-only:
127
+
128
+ ```bash
129
+ autocoding feedback --projects /path/geestock,/path/geesight,/path/xjmate --json
130
+ ```
131
+
132
+ The collector scans only bounded report metadata from the listed projects,
133
+ executes nothing from the documents, changes no repository, and groups exact
134
+ root-cause signatures. Human triage still decides whether an observation is a
135
+ shared defect, project configuration, environment issue, duplicate, or missing
136
+ evidence before fixes and a release are planned.
137
+
138
+ After a project upgrade, verify each requested action. Fixed reports should be
139
+ deleted or updated to `resolved`; current regressions should update their last
140
+ verified version; project-only preferences belong in
141
+ `docs/project/auto-coding-skill.yaml` and should be removed from active feedback.
142
+
143
+ Fill the project/Jenkins/GitLab/Nexus URL, username, and password overrides under
144
+ `access.*` in `docs/project/auto-coding-skill.yaml`, then configure one real fast
145
+ validation command and run:
80
146
 
81
147
  ```bash
82
148
  python3 docs/tools/autopipeline/ap.py doctor
@@ -320,6 +386,43 @@ model overrides, complete project `risk.rules`, supported project/access/
320
386
  concurrency/route/structure values, and an existing project-owned structure
321
387
  standard byte-for-byte. Removed content is archived outside active docs.
322
388
 
389
+ ## What changed in 4.3.1
390
+
391
+ - Replaced extension-bound documentation preservation with recursive ownership
392
+ for designated project documentation roots. PNG, SVG, JSON, YAML, binary, and
393
+ nested assets now remain byte-identical across status, dry-run, init, and sync;
394
+ active documentation symlinks and special files fail before writes.
395
+ - Added the managed, signature-keyed feedback resolution catalog and compatible
396
+ v1/v2 report parsing. Collection now separates active and closed reports and
397
+ derives release-aware upgrade, recheck, verification, regression, closure, and
398
+ project-overlay routing states without modifying project-owned reports.
399
+ - Surfaced feedback maintenance as non-blocking status, sync, init, and doctor
400
+ advisories, while keeping explicit feedback collection strict, bounded,
401
+ metadata-only, and read-only.
402
+
403
+ ## What changed in 4.3.0
404
+
405
+ - Made `docs/ENGINEERING.md` the exact managed default layer and added
406
+ `docs/project/auto-coding-skill.yaml` as the higher-priority project-owned
407
+ overlay. Mappings merge recursively; explicit project scalars and lists replace
408
+ defaults, while managed workflow identity and code-enforced safety invariants
409
+ remain protected.
410
+ - Added one-time semantic migration from the previous manifest-bound default.
411
+ Initialization creates the overlay without overwriting an existing one, proves
412
+ the reconstructed effective configuration is equivalent, archives the legacy
413
+ document, and then converges the managed default byte-for-byte.
414
+ - Added `docs/skill-feedback/` with managed guidance/template and preserved
415
+ project-owned reports. `autocoding feedback --projects ... --json` performs an
416
+ explicit bounded metadata-only read and groups exact root-cause signatures for
417
+ later human triage.
418
+ - Replaced partial upgrade writes with owner-bound, recoverable installation
419
+ transactions, staged/installed hash checks, active-installer rejection, safe
420
+ project-file operations, and fail-closed effective-configuration validation.
421
+ Project-local `ap.py upgrade --write` is retired in favor of transactional
422
+ `autocoding init` or explicit multi-project `sync`.
423
+ - Batched protected executable-mode convergence so the safer installer retains
424
+ practical upgrade latency while preserving symlink/reparse checks.
425
+
323
426
  ## What changed in 4.2.8
324
427
 
325
428
  - 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.1","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.1"},{"path":".agents/agents/docs-researcher.toml","source":"agents/docs-researcher.toml","ownership":"normalized-agent","sha256":"aa1fed6a6a1cde282fc152c7a88b8e097a6c53bcf447d35978607d594e3cb3e4","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/agents/explorer.toml","source":"agents/explorer.toml","ownership":"normalized-agent","sha256":"4cd89888acf7c0c04fbbcd0b9a0f346c6efed42fb723ec2037af9331a84a1cac","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/agents/fixer.toml","source":"agents/fixer.toml","ownership":"normalized-agent","sha256":"7bc00a45b9d1bcc90b8b0f06d773556eba1d52effff664472c3cb81073f6abfb","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/agents/reviewer.toml","source":"agents/reviewer.toml","ownership":"normalized-agent","sha256":"e1ad676e608ffee04d782571fb9bfbc787f69c100941b1811d955ef80439db36","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/skills/auto-coding-skill/SKILL.md","source":"skill/SKILL.md","ownership":"exact","sha256":"d142951aa5cd7062ec467421654c7cda0a9dac2262eedc97a92590428b3a21e7","executable":false,"scope":"shared","version":"4.3.1"},{"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.1"},{"path":".agents/skills/auto-coding-skill/data/policies/feedback-resolutions-v1.json","source":"skill/data/policies/feedback-resolutions-v1.json","ownership":"exact","sha256":"4e752685028a89adf6d403d745bbef2ec4288d3aff7b11d6ec0c2df147c67798","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/skills/auto-coding-skill/data/policies/workflow-migrations-v1.json","source":"skill/data/policies/workflow-migrations-v1.json","ownership":"exact","sha256":"3f822403a3bd9898d58e2be4b27fd21300daaa6406bea2b6fc2402079d887664","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/skills/auto-coding-skill/data/templates/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"d77683b744db285cffd2241fa822490901a06e6b5b83ec2abd438466d6dc9eb6","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/skills/auto-coding-skill/data/templates/bridges/AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"f7d724be47ffa90a1af468085f0908d7eee45b37bf76ea3138c96f3300138cf0","executable":false,"scope":"shared","version":"4.3.1"},{"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.1"},{"path":".agents/skills/auto-coding-skill/requirements.txt","source":"skill/requirements.txt","ownership":"exact","sha256":"0969da99a0bc2a1b71ed50584560f4588a37567ac63af3ddbaf3c4617ca5621a","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/skills/auto-coding-skill/scripts/ap.py","source":"skill/scripts/ap.py","ownership":"exact","sha256":"44f1ef4dff7fedb210ed984925bb410da83b09d92ea8bf09fecfb06bcaabdf2a","executable":false,"scope":"shared","version":"4.3.1"},{"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.1"},{"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.1"},{"path":".agents/skills/auto-coding-skill/scripts/install_integrity.py","source":"skill/scripts/install_integrity.py","ownership":"exact","sha256":"41a2df7935027fb43cfcb3d18e57a7f33adc4861420ff43c8828743ad71cc429","executable":false,"scope":"shared","version":"4.3.1"},{"path":".agents/skills/auto-coding-skill/scripts/scaffold_templates.py","source":"skill/scripts/scaffold_templates.py","ownership":"exact","sha256":"7f25761cc065bb8c2875c8c99bea9077d339dedae81aeeddfab1c35f4cf054b3","executable":false,"scope":"shared","version":"4.3.1"},{"path":"AGENTS.md","source":"skill/data/templates/bridges/AGENTS.md","ownership":"exact","sha256":"f7d724be47ffa90a1af468085f0908d7eee45b37bf76ea3138c96f3300138cf0","executable":false,"scope":"project","version":"4.3.1"},{"path":"docs/ENGINEERING.md","source":"skill/data/templates/ENGINEERING.md","ownership":"exact","sha256":"d77683b744db285cffd2241fa822490901a06e6b5b83ec2abd438466d6dc9eb6","executable":false,"scope":"project","version":"4.3.1"},{"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.1"},{"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.1"},{"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.1"},{"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.1"},{"path":"docs/skill-feedback/README.md","source":"generated:scaffold_templates:docs/skill-feedback/README.md","ownership":"exact","sha256":"3b146e1b7e7a1d4af57635307b825b38ce7bc58d1ee5f98871c877a64936edab","executable":false,"scope":"project","version":"4.3.1"},{"path":"docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md","source":"generated:scaffold_templates:docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md","ownership":"exact","sha256":"90ff26074305f8da537892060ffbc3a0206841702ed0483545e4ebe84e3ff357","executable":false,"scope":"project","version":"4.3.1"},{"path":"docs/tools/autopipeline/ap.py","source":"skill/data/templates/tools/ap.py","ownership":"exact","sha256":"c352fbf2cbcb9692a34fd952d8541b1cbe6d475c6e11e64500a1f6b5283a00be","executable":false,"scope":"project","version":"4.3.1"}],"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/auto-coding-skill.yaml","docs/architecture/structure-standard.md","docs/architecture/** (except exact-managed entries)","docs/bugs/** (except exact-managed entries)","docs/deployment/** (except exact-managed entries)","docs/design/** (except exact-managed entries)","docs/interfaces/** (except exact-managed entries)","docs/project/** (except exact-managed entries)","docs/reviews/** (except exact-managed entries)","docs/testing/** (except exact-managed entries)","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.
@@ -0,0 +1,15 @@
1
+ {
2
+ "schema": "auto-coding-skill-feedback-resolutions/v1",
3
+ "entries": [
4
+ {
5
+ "signature": "sha256:a5eeb5eb0ef5073dbeec726fa6c2016593b43eb1230171e3028f364c5b07bd86",
6
+ "disposition": "project-config",
7
+ "effective_skill_version": "4.3.1"
8
+ },
9
+ {
10
+ "signature": "sha256:fd5748e4ae40e9f86762c4f62b3302bbbb2b8ae9661adf9e0e07a2327ccf7a36",
11
+ "disposition": "fixed",
12
+ "effective_skill_version": "4.3.1"
13
+ }
14
+ ]
15
+ }
@@ -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.1",
5
+ "engineering": "4.3.1"
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.1"
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.1 -->
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.1 -->
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,12 @@ 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 in `docs/project/auto-coding-skill.yaml`, redact
142
+ sensitive/raw evidence, and never mutate a frozen Reviewer diff merely to add
143
+ feedback. Periodically run `autocoding feedback --projects . --json`; after an
144
+ upgrade, verify and close/delete fixed reports or update current regressions.
139
145
  - Pure ledger/archive reconciliation is terminal: validate, commit once, and stop.
140
146
  - Fill configured project/Jenkins/GitLab/Nexus access fields during initialization.
141
147
  Plaintext values are allowed; do not invent or unnecessarily echo credentials.