Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "engineering-everything",
"version": "0.12.0",
"version": "0.13.0",
"description": "Bootloader and engineering-route skills for product definition, project inheritance, architecture, execution, verification, refactoring, release, organization systems, automation, and skill evolution.",
"author": {
"name": "Anthony Fan",
Expand Down
17 changes: 17 additions & 0 deletions .codex/hooks.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"hooks": {
"SessionStart": [
{
"matcher": "startup|resume",
"hooks": [
{
"type": "command",
"command": "/usr/bin/python3 \"$(git rev-parse --show-toplevel)/.evozeus-wrapper/hooks/evozeus_wrapper_start_check.py\"",
"timeout": 30,
"statusMessage": "Checking EvoZeus wrapper harness"
}
]
}
]
}
}
54 changes: 42 additions & 12 deletions CHANGELOG.md → .evozeus-wrapper/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,50 @@

All notable changes to engineering-everything are recorded here.

Wrapper harness migrations are recorded under `docs/wrapper-migrations/`. Add them here only when the migration also changes this Skill's release contract.
Wrapper harness migrations are recorded under `.evozeus-wrapper/docs/migrations/`. Add them here only when the migration also changes this Skill's release contract.

## [Unreleased]

- Publish the validated `v0.13.0` package and CoEvolve migration after the linked pull request merges; clear this coordination entry in the release commit.

## [v0.13.0] - 2026-07-25

### Skill changes

- Demoted root `SKILL.md`: runtime entrypoints now live only under `skills/*/SKILL.md`.
- Updated package, self-evolution, and wrapper preflight gates to use `.codex-plugin/plugin.json` plus the plugin skill library as the package contract.
- Updated wrapper/dashboard docs to describe plugin-first source governance.
- Migrated the EvoZeus-CoEvolve harness from scattered layout `v0.3.0` to consolidated layout `v0.11.2`.
- Kept `skills/using-engineering-everything/SKILL.md` as the recommended bootloader and preserved all direct sub-Skill entrypoints.
- Aligned `scripts/install.py --target both` with its documented contract by creating canonical sub-Skill symlinks for Codex and Agents on fresh installs.

### Feedback / Issues

- Owner request: use Engineering Everything as the first non-project Skillware feasibility target for EvoZeus-CoEvolve.
- Related issue: https://github.com/HaodiFan/engineering-everything/issues/17
- Migration recovery: the first structure gate exposed missing legacy policy files and root-only runtime pointer assumptions; CoEvolve v0.11.2 fixed both without weakening validation.

### Version Plan
### Verification

- `python3 scripts/sync_references.py --check --json`
- `python3 scripts/eval_scenarios.py validate --json`
- `python3 scripts/skill_doctor.py --json`
- `python3 scripts/self_evolve.py check --json`
- `python3 scripts/self_evolve.py doctor --json`
- `python3 scripts/lesson.py validate`
- `python3 -m unittest discover -s tests`
- `python3 -m py_compile scripts/*.py`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py structure`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything --current-tag v0.13.0`

### Release notes

- Recommended next release: `v0.13.0`.
- Rationale: package structure changes while runtime behavior remains routed through existing library skills.
- Major pre-1.0 package transition: plugin-first runtime entrypoints replace the retired root Skill entry.
- CoEvolve adds lifecycle governance and a recommended-entry preflight; it does not change Engineering Everything routing decisions.
- Fresh plugin-library installs now maintain one canonical source through symlinks instead of copied runtime directories.
- Native per-Skill invocation hooks remain unavailable; the bootloader preflight depends on instruction compliance.
- License remains `UNLICENSED`.

## [v0.12.0] - 2026-06-28

Expand Down Expand Up @@ -66,10 +96,10 @@ Wrapper harness migrations are recorded under `docs/wrapper-migrations/`. Add th
- `python3 scripts/skill_doctor.py --json`
- `python3 scripts/self_evolve.py check --json`
- `python3 scripts/self_evolve.py doctor --json`
- `python3 scripts/evozeus_wrapper_preflight.py structure`
- `python3 scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`
- `python3 scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything --current-tag v0.11.0`
- `python3 scripts/evozeus_wrapper_preflight.py release --tag v0.11.0 --release-notes /tmp/engineering-everything-v0.11.0-release-notes.md --skip-gh`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py structure`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything --current-tag v0.11.0`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py release --tag v0.11.0 --release-notes /tmp/engineering-everything-v0.11.0-release-notes.md --skip-gh`

## [v0.10.0] - 2026-06-27

Expand All @@ -88,10 +118,10 @@ Wrapper harness migrations are recorded under `docs/wrapper-migrations/`. Add th
- `python3 scripts/skill_doctor.py --json`
- `python3 scripts/self_evolve.py check --json`
- `python3 scripts/self_evolve.py doctor --json`
- `python3 scripts/evozeus_wrapper_preflight.py structure`
- `python3 scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`
- `python3 scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything --current-tag v0.10.0`
- `python3 scripts/evozeus_wrapper_preflight.py release --tag v0.10.0 --release-notes release-notes.md --skip-gh`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py structure`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything --current-tag v0.10.0`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py release --tag v0.10.0 --release-notes release-notes.md --skip-gh`

## [v0.9.10] - 2026-06-27

Expand Down
40 changes: 20 additions & 20 deletions WRAPPER.md → .evozeus-wrapper/WRAPPER.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,24 +7,24 @@ This repo is a wrapped Skill repo generated by EvoZeus-wrapper.
- Plugin manifest: `.codex-plugin/plugin.json`
- Runtime skills: `skills/*/SKILL.md`
- EvoZeus project pointer: `~/.evozeus/.projects/HaodiFan/engineering-everything`
- Dashboard page: `docs/index.md`
- Dashboard page: `.evozeus-wrapper/docs/index.md`
- Feedback Issue template: `.github/ISSUE_TEMPLATE/skill-feedback.yml`
- Design doc template: `docs/design-doc-template.md`
- Wrapper migration log: `docs/wrapper-migrations/`
- Changelog: `CHANGELOG.md`
- Preflight checker: `scripts/evozeus_wrapper_preflight.py`
- Wrapper manifest: `.evozeus/wrapper.json`
- Design doc template: `.evozeus-wrapper/docs/design-doc-template.md`
- Wrapper migration log: `.evozeus-wrapper/docs/migrations/`
- Changelog: `.evozeus-wrapper/CHANGELOG.md`
- Preflight checker: `.evozeus-wrapper/scripts/evozeus_wrapper_preflight.py`
- Wrapper manifest: `.evozeus-wrapper/wrapper.json`
- Current Skill version: `v0.12.0`
- Wrapper harness version: `v0.3.0`

## Runtime Status Check

This repo uses a plugin-first layout. Runtime behavior starts from `skills/using-engineering-everything/SKILL.md` or `skills/engineering-everything/SKILL.md`; package governance lives in `.codex-plugin/plugin.json`, `WRAPPER.md`, `docs/index.md`, and `references/self-evolution-harness.md`.
This repo uses a plugin-first layout. Runtime behavior starts from `skills/using-engineering-everything/SKILL.md` or `skills/engineering-everything/SKILL.md`; package governance lives in `.codex-plugin/plugin.json`, `.evozeus-wrapper/WRAPPER.md`, `.evozeus-wrapper/docs/index.md`, and `references/self-evolution-harness.md`.

Before evolving or publishing the Skill package:

1. Check the current Skill release against GitHub latest release.
2. Check `.evozeus/wrapper.json` against the current EvoZeus-wrapper harness version.
2. Check `.evozeus-wrapper/wrapper.json` against the current EvoZeus-wrapper harness version.
3. Check the source contract with `doctor`.
4. Continue to the target Skill's main flow only after all three are OK.

Expand All @@ -41,26 +41,26 @@ If this repo is private, do not assume the GitHub Pages output is private. Keep

1. The target repo is the canonical Skill source. EvoZeus and runtime installs should point to it instead of keeping copied installs.
2. Before evolving or running a wrapper-managed Skill, resolve the source in this order:
- read `.evozeus/wrapper.json`;
- read `.evozeus-wrapper/wrapper.json`;
- check `~/.evozeus/.projects/HaodiFan/engineering-everything`;
- verify the canonical repo git origin / GitHub repo;
- inspect runtime installs only as pointers;
- use GitHub user/org/public search only as fallback when wrapper state is absent.
3. Before running the Skill, check whether GitHub has a newer release:
`python3 scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything`
`python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything`
4. User reports an unsatisfactory Skill result with the feedback Issue template.
5. Maintainer writes a design doc in `docs/designs/`.
5. Maintainer writes a design doc in `.evozeus-wrapper/docs/designs/`.
6. Maintainer opens a PR referencing the design doc.
7. PR updates plugin/library files and `CHANGELOG.md`.
7. PR updates plugin/library files and `.evozeus-wrapper/CHANGELOG.md`.
8. Release tag and release description are created after merge.

## Wrapper Harness Upgrade

The Skill release version and wrapper harness version are separate axes.

- Skill release is tracked by GitHub releases and `CHANGELOG.md`.
- Wrapper harness version is tracked by `.evozeus/wrapper.json`.
- Wrapper migrations are recorded under `docs/wrapper-migrations/`.
- Skill release is tracked by GitHub releases and `.evozeus-wrapper/CHANGELOG.md`.
- Wrapper harness version is tracked by `.evozeus-wrapper/wrapper.json`.
- Wrapper migrations are recorded under `.evozeus-wrapper/docs/migrations/`.

When EvoZeus-wrapper publishes a newer harness version, do not rewrite target Skill business rules. Generate a migration plan from the EvoZeus-wrapper repo:

Expand All @@ -82,9 +82,9 @@ Use `vMAJOR.MINOR.PATCH`.
## Local Checks

```bash
python3 scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything
python3 scripts/evozeus_wrapper_preflight.py structure
python3 scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything
python3 scripts/evozeus_wrapper_preflight.py pr --design-doc docs/designs/<design-doc>.md
python3 scripts/evozeus_wrapper_preflight.py release --tag v0.12.0 --release-notes /tmp/engineering-everything-v0.12.0-release-notes.md
python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything
python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py structure
python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything
python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py pr --design-doc .evozeus-wrapper/docs/designs/<design-doc>.md
python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py release --tag v0.12.0 --release-notes /tmp/engineering-everything-v0.12.0-release-notes.md
```
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
Make `engineering-everything` self-evolving through both layers:

- Skill-native gates: `scripts/skill_doctor.py` and `scripts/self_evolve.py`.
- Wrapper-managed gates: `.evozeus/wrapper.json`, feedback Issue template, design docs, migration log, and `scripts/evozeus_wrapper_preflight.py`.
- Wrapper-managed gates: `.evozeus-wrapper/wrapper.json`, feedback Issue template, design docs, migration log, and `.evozeus-wrapper/scripts/evozeus_wrapper_preflight.py`.

## Direction

Expand All @@ -21,21 +21,21 @@ The change is append-only for Skill runtime behavior:

- Preserve existing routing and reference files.
- Append wrapper source-discovery and migration sections to root `SKILL.md`.
- Record wrapper harness version in `.evozeus/wrapper.json`.
- Record wrapper harness version in `.evozeus-wrapper/wrapper.json`.
- Keep wrapper version separate from Skill release version.

## Implementation plan

- Skill sections to change: append `## 自进化方法` and `## EvoZeus-wrapper` to root `SKILL.md`.
- Files to update: wrapper-managed templates, `CHANGELOG.md`, version metadata, and migration docs.
- Files to update: wrapper-managed templates, `.evozeus-wrapper/CHANGELOG.md`, version metadata, and migration docs.
- Backward compatibility: existing route seeds, references, and subskill routing remain unchanged.

## Verification plan

- Source discovery check: `python3 scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`.
- Manual checks: confirm `.evozeus/wrapper.json` has `wrapper_version: v0.2.0` and `canonical_repo: HaodiFan/engineering-everything`.
- Source discovery check: `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`.
- Manual checks: confirm `.evozeus-wrapper/wrapper.json` has `wrapper_version: v0.2.0` and `canonical_repo: HaodiFan/engineering-everything`.
- Regression cases: verify `scripts/skill_doctor.py`, `scripts/self_evolve.py check`, and `scripts/self_evolve.py doctor` still pass.
- Preflight command: `python3 scripts/evozeus_wrapper_preflight.py structure`.
- Preflight command: `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py structure`.

## Release plan

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,25 +22,25 @@ This is a harness migration, not a routing behavior change:

- Preserve Engineering Everything's existing route priority and subskill map.
- Keep Skill release version separate from wrapper harness version.
- Record the wrapper migration under `docs/wrapper-migrations/`.
- Record the wrapper migration under `.evozeus-wrapper/docs/migrations/`.

## Implementation plan

- Add `EvoZeus-wrapper 状态检查` at the top of root `SKILL.md` after frontmatter.
- Update wrapper-managed dashboard files to record Skill `v0.11.0` and wrapper `v0.3.0`.
- Copy the `v0.3.0` wrapper preflight checker.
- Update `.evozeus/wrapper.json` to `wrapper_version: v0.3.0`.
- Update `.evozeus-wrapper/wrapper.json` to `wrapper_version: v0.3.0`.
- Add changelog and migration records.

## Verification plan

- `python3 scripts/skill_doctor.py --json`
- `python3 scripts/self_evolve.py check --json`
- `python3 scripts/self_evolve.py doctor --json`
- `python3 scripts/evozeus_wrapper_preflight.py structure`
- `python3 scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`
- `python3 scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything --current-tag v0.11.0`
- `python3 scripts/evozeus_wrapper_preflight.py release --tag v0.11.0 --release-notes /tmp/engineering-everything-v0.11.0-release-notes.md --skip-gh`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py structure`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py doctor --repo HaodiFan/engineering-everything`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py version --repo HaodiFan/engineering-everything --current-tag v0.11.0`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py release --tag v0.11.0 --release-notes /tmp/engineering-everything-v0.11.0-release-notes.md --skip-gh`

## Release plan

Expand All @@ -52,4 +52,4 @@ This is a harness migration, not a routing behavior change:

- Risk: agents may treat the status prelude as a replacement for Engineering Everything's existing route logic.
- Mitigation: the status prelude explicitly says the main flow starts only after checks pass; it does not redefine routing.
- Rollback plan: revert the migration commit and restore `.evozeus/wrapper.json` to `v0.2.0`.
- Rollback plan: revert the migration commit and restore `.evozeus-wrapper/wrapper.json` to `v0.2.0`.
Original file line number Diff line number Diff line change
Expand Up @@ -169,15 +169,15 @@ tests/
- supported/experimental/not-yet harness matrix;
- install/update/uninstall lifecycle;
- current limitations.
- Move maintainer dashboard content out of `docs/index.md` or make it clearly maintainer-only.
- Move maintainer dashboard content out of `.evozeus-wrapper/docs/index.md` or make it clearly maintainer-only.
- Add PR template Behavior Evaluation fields:
- scenario IDs;
- entrypoint;
- expected/actual;
- pass/fail;
- harness/model/date.
- Update workflow to run real gates, not only wrapper PR preflight.
- Update `CHANGELOG.md` Unreleased for this scope.
- Update `.evozeus-wrapper/CHANGELOG.md` Unreleased for this scope.

### Phase 3 - Optional SessionStart hook

Expand Down Expand Up @@ -233,7 +233,7 @@ These are valid before implementation:
- `python3 scripts/skill_doctor.py --json`
- `python3 scripts/self_evolve.py check --json`
- `python3 scripts/lesson.py validate`
- `python3 scripts/evozeus_wrapper_preflight.py pr --design-doc docs/designs/2026-06-28-agentos-bootloader-refactor.md`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py pr --design-doc .evozeus-wrapper/docs/designs/2026-06-28-agentos-bootloader-refactor.md`

### Phase 0 acceptance

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@

- package version 事实源是 `.codex-plugin/plugin.json`。
- runtime entry 只来自 `skills/using-engineering-everything/SKILL.md` 和 `skills/engineering-everything/SKILL.md`。
- EvoZeus/source governance 进入 `WRAPPER.md`、`docs/index.md` 和 `references/self-evolution-harness.md`。
- EvoZeus/source governance 进入 `.evozeus-wrapper/WRAPPER.md`、`.evozeus-wrapper/docs/index.md` 和 `references/self-evolution-harness.md`。
- legacy whole-repo skill install 不再作为推荐路径。

## Direction
Expand All @@ -24,15 +24,15 @@
1. 删除 root `SKILL.md`。
2. 更新 `scripts/skill_doctor.py`,以 plugin manifest 为 package version source。
3. 更新 `scripts/self_evolve.py`,检查 plugin/library contract,不再要求 root Skill。
4. 更新 `scripts/evozeus_wrapper_preflight.py`,检查 plugin/library wrapper contract,不再要求 root status prelude。
4. 更新 `.evozeus-wrapper/scripts/evozeus_wrapper_preflight.py`,检查 plugin/library wrapper contract,不再要求 root status prelude。
5. 更新 README、dashboard、WRAPPER 和 changelog,把 root Skill 从当前结构中移除。
6. 跑完整本地 gate。

## Verification plan

- `python3 scripts/skill_doctor.py --json`
- `python3 scripts/self_evolve.py check --json`
- `python3 scripts/evozeus_wrapper_preflight.py structure`
- `python3 .evozeus-wrapper/scripts/evozeus_wrapper_preflight.py structure`
- `python3 scripts/eval_scenarios.py validate --json`
- `python3 scripts/sync_references.py --check --json`
- `python3 scripts/lesson.py validate`
Expand Down
Loading
Loading