Skip to content

chore(aethyme): redeploy agent instructions for v0.8.13 #190

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
schiste merged 1 commit into from
Oct 1, 2026
Merged

chore(aethyme): redeploy agent instructions for v0.8.13 #190

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
15 changes: 10 additions & 5 deletions .aethyme/generated/onboarding.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,7 @@
"member_count": 22,
"ci_mentions": 0,
"executable_entrypoints": 7,
"source_files": 208
"source_files": 215
}
},
{
Expand Down Expand Up @@ -246,7 +246,7 @@
"member_count": 22,
"ci_mentions": 0,
"executable_entrypoints": 7,
"source_files": 208
"source_files": 215
}
},
"commands": [
Expand Down Expand Up @@ -454,6 +454,11 @@
}
],
"dangerous_paths": [
{
"path": ".aethyme/gates.toml",
"reason": "repository validation policy; changes affect every broker submission",
"provenance": "tracked path classification"
},
{
"path": ".github/workflows",
"reason": "repository automation; changes can affect publication or shared CI",
Expand Down Expand Up @@ -496,9 +501,9 @@
]
},
"freshness": {
"source_digest": "14e149ab00837e2bef45608be9aced9758b822047913e88db2b33df2deacd459",
"source_digest": "6a4bec8975cc8172bad693d32fbf33724a37dfd7958b06118ec8a665f0b01c57",
"source_commit": null,
"source_file_count": 525,
"source_file_count": 539,
"generator": "deterministic"
},
"telemetry": {
Expand All @@ -523,7 +528,7 @@
"entrypoints": 8,
"caution_zones": 1,
"generated_paths": 1,
"dangerous_paths": 1,
"dangerous_paths": 2,
"navigation_recipes": 3,
"notes": 0
},
Expand Down
57 changes: 57 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,60 @@
# Agent Instructions
<!-- AETHYME-GENERATED: version=0.8.13; policy-sha256=235f2917e0e21265243d9685b9fc1279423e8848f4be6ca8568c0893fa19301a -->

Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json`
(policy) or `.aethyme/overrides/onboarding.json` (orientation), then run
`aethyme deploy --repo "$PWD"`.

## This repository

`SP42`: rust repository (cargo). Fast test: `cargo test --workspace`. App entrypoint: `Procfile:web`.
Orientation: `.claude/skills/repo-onboarding/SKILL.md`, then `.claude/skills/repo-act/SKILL.md` (Codex: `.codex/skills/repo-onboarding/SKILL.md`, `.codex/skills/repo-act/SKILL.md`). Status: `.aethyme/generated/experience-status.md`.

## Broker Coordination: before and after an edit

Other agents may be working in sibling worktrees.

1. `aethyme broker start --task "<task>"`, then work only in the worktree it
reports and follow the working agreement it prints. Never edit another
session's worktree.
Comment on lines +17 to +19

@chatgpt-codex-connector chatgpt-codex-connector Bot Oct 1, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Keep Aethyme workflow conditional on local activation

When .aethyme/local/enabled is absent—as it is in the reviewed tree—the retained maintainer policy explicitly requires agents to continue normally without running Aethyme, while this new unconditional step requires every edit to begin with aethyme broker start and later be pushed and submitted through the broker. This leaves every non-opted-in clone with mutually exclusive instructions and can trigger broker worktrees or draft PRs despite the local-only policy; gate the generated workflow on the activation flag or deliberately remove the conflicting policy.

AGENTS.md reference: AGENTS.md:L61-L64

Useful? React with 👍 / 👎.

2. Commit early and small, and after each commit run
`aethyme broker push --session <id>`. Once there is a first meaningful
commit, open a draft PR with `aethyme broker push --session <id> --pr`, and
keep pushing until it is ready. Run `aethyme broker sync --session <id>`
before resuming a reused session and whenever push reports the branch is
behind the default branch. Never leave work only in the worktree.
3. When done: `aethyme broker submit --session <id>`, then
`aethyme broker finish --session <id>` (it refuses while commits are unpushed).

This repository's `push_session_branches` policy authorizes pushing your own
session branch and opening a draft PR; nothing else. Other remote or shared Git
and GitHub writes go through `aethyme broker advanced git` and
`aethyme broker advanced gh`. If `.aethyme/broker-action-required.md` appears,
read it first. Leases, gates, advisories and recovery: `references/broker.md`.

## Finding code

For "where is X" questions, try `aethyme explore --request "<question>" --format brief`
first: one call prints a ranked summary and the top verified source spans. It
is a navigation aid, not an answer. Verify the spans before relying on them.

## Commits

Subject `type(scope): summary`. Types: `fix`, `feat`, `refactor`, `perf`, `test`, `docs`, `build`, `chore`, `revert`.
Substantive commits (`fix`, `feat`, `refactor`, `perf`) need `Problem`, `Decision`, `Rationale` and `Validation` sections; the others may be subject-only.
Check with `aethyme repo lint-commit-message <file>`.

## Everything else

Load the Aethyme skill: `.claude/skills/aethyme/SKILL.md` (Codex:
`.codex/skills/aethyme/SKILL.md`). Its `references/` hold the detail:
`explore.md` (depth, intents, retries), `broker.md` (leases, gates, Git and
GitHub coordination, publication, recovery), `policy.md` (commit format,
branch and review practice, verifying these files), `graph-task.md` and
`dead-code.md`.

## Maintainer Notes

<!-- aethyme-local:begin -->
## Optional local Aethyme activation

Expand Down
57 changes: 57 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,60 @@
# Agent Instructions
<!-- AETHYME-GENERATED: version=0.8.13; policy-sha256=235f2917e0e21265243d9685b9fc1279423e8848f4be6ca8568c0893fa19301a -->

Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json`
(policy) or `.aethyme/overrides/onboarding.json` (orientation), then run
`aethyme deploy --repo "$PWD"`.

## This repository

`SP42`: rust repository (cargo). Fast test: `cargo test --workspace`. App entrypoint: `Procfile:web`.
Orientation: `.claude/skills/repo-onboarding/SKILL.md`, then `.claude/skills/repo-act/SKILL.md` (Codex: `.codex/skills/repo-onboarding/SKILL.md`, `.codex/skills/repo-act/SKILL.md`). Status: `.aethyme/generated/experience-status.md`.

## Broker Coordination: before and after an edit

Other agents may be working in sibling worktrees.

1. `aethyme broker start --task "<task>"`, then work only in the worktree it
reports and follow the working agreement it prints. Never edit another
session's worktree.
2. Commit early and small, and after each commit run
`aethyme broker push --session <id>`. Once there is a first meaningful
commit, open a draft PR with `aethyme broker push --session <id> --pr`, and
keep pushing until it is ready. Run `aethyme broker sync --session <id>`
before resuming a reused session and whenever push reports the branch is
behind the default branch. Never leave work only in the worktree.
3. When done: `aethyme broker submit --session <id>`, then
`aethyme broker finish --session <id>` (it refuses while commits are unpushed).

This repository's `push_session_branches` policy authorizes pushing your own
session branch and opening a draft PR; nothing else. Other remote or shared Git
and GitHub writes go through `aethyme broker advanced git` and
`aethyme broker advanced gh`. If `.aethyme/broker-action-required.md` appears,
read it first. Leases, gates, advisories and recovery: `references/broker.md`.

## Finding code

For "where is X" questions, try `aethyme explore --request "<question>" --format brief`
first: one call prints a ranked summary and the top verified source spans. It
is a navigation aid, not an answer. Verify the spans before relying on them.

## Commits

Subject `type(scope): summary`. Types: `fix`, `feat`, `refactor`, `perf`, `test`, `docs`, `build`, `chore`, `revert`.
Substantive commits (`fix`, `feat`, `refactor`, `perf`) need `Problem`, `Decision`, `Rationale` and `Validation` sections; the others may be subject-only.
Check with `aethyme repo lint-commit-message <file>`.

## Everything else

Load the Aethyme skill: `.claude/skills/aethyme/SKILL.md` (Codex:
`.codex/skills/aethyme/SKILL.md`). Its `references/` hold the detail:
`explore.md` (depth, intents, retries), `broker.md` (leases, gates, Git and
GitHub coordination, publication, recovery), `policy.md` (commit format,
branch and review practice, verifying these files), `graph-task.md` and
`dead-code.md`.

## Maintainer Notes

<!-- aethyme-local:begin -->
## Optional local Aethyme activation

Expand Down
Loading