@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 +82 -5
- package/cli/assets/managed-install.json +1 -1
- package/cli/assets/skill/SKILL.md +7 -7
- package/cli/assets/skill/data/policies/workflow-migrations-v1.json +2 -2
- package/cli/assets/skill/data/templates/ENGINEERING.md +17 -12
- package/cli/assets/skill/data/templates/bridges/AGENTS.md +12 -8
- package/cli/assets/skill/scripts/ap.py +2711 -529
- package/cli/assets/skill/scripts/core.py +363 -1
- package/cli/assets/skill/scripts/install_integrity.py +6 -4
- package/cli/assets/skill/scripts/scaffold_templates.py +99 -0
- package/cli/src/index.js +1128 -322
- package/cli/tests/ap_concurrency_test.py +1 -1
- package/cli/tests/ap_profiles_test.py +72 -33
- package/cli/tests/core_shell_test.py +261 -0
- package/cli/tests/index.test.js +1577 -180
- package/package.json +1 -1
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;
|
|
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`
|
|
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
|
-
|
|
79
|
-
|
|
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.
|
|
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`
|
|
12
|
-
`docs/project/` for durable
|
|
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
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
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,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
workflow:
|
|
3
|
-
skill_version: "4.
|
|
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.
|
|
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
|
|
89
|
-
|
|
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`:
|
|
99
|
-
|
|
100
|
-
- `structure` and `optimization`:
|
|
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
|
|
105
|
-
|
|
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.
|
|
109
|
-
|
|
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.
|
|
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
|
-
|
|
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`
|
|
15
|
-
|
|
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
|
|
128
|
-
|
|
129
|
-
|
|
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.
|