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
4 changes: 2 additions & 2 deletions .aethyme/generated/onboarding.json
Original file line number Diff line number Diff line change
Expand Up @@ -501,9 +501,9 @@
]
},
"freshness": {
"source_digest": "1cc729348eeead667dcc0ac274bc2e9cb91df1799a0a670316fd6e3abacd14f5",
"source_digest": "50b057d5f9ff1851a21d4b1ecac1b9454323cb851d29d19edf383d3c51415671",
"source_commit": null,
"source_file_count": 539,
"source_file_count": 540,
"generator": "deterministic"
},
"telemetry": {
Expand Down
7 changes: 3 additions & 4 deletions .codex/skills/aethyme/aethyme-explore
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,9 @@
# Native Rust thin client for `aethyme explore` — the canonical hot path.
#
# This wrapper is the convenience entry point for in-repo skill consumers.
# The `aethyme` binary detects an engine daemon and routes to the native
# Rust `aethyme-engine-cli explore` for sub-second warm latency. If no
# daemon is running, it falls back to the Python daemon / subprocess
# transparently.
# The aethyme binary routes to the native engine daemon for sub-second warm
# latency. If no daemon is running, it starts the Rust daemon and retries;
# the first map build can take a minute on large repos.
#
# Replaced the soft-retired Python `python -m src.cli explore` wrapper
# on 2026-05-08 (task #59 — Python explore hard-deleted).
Expand Down
8 changes: 8 additions & 0 deletions .codex/skills/aethyme/references/broker.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,12 @@ blocked.
back as a warning naming the holder, with the `note send` command to
coordinate.

Orchestration with no path -- a release, a merge chain -- is claimed by
name instead: `aethyme broker advanced ownership claim "release v1.2.0"
--session <your-session-id> --reason "<why>"`. `status` shows every claim,
its holder and when the holder last acted; a claim is refused only while
its holder is working, and a quiet holder's claim is taken over.

3. **Guard broad rewrite commands**. For formatters, code generators, or any
command likely to touch many files, run through the broker guard:

Expand Down Expand Up @@ -103,6 +109,8 @@ blocked.
`aethyme broker sync --session <id>` when it warns, before the pull request
reports the conflict: it rebases an unpublished branch or merges the default
branch into a published one, and changes nothing if that would conflict.
Sync is local only: it never pushes, so run `aethyme broker push --session
<id>` afterwards to publish the caught-up branch.
`broker start` and `start --reuse` refresh the default branch first, so a
new worktree starts from the latest fetched tip. In a repository
with `[promote] mode = "verify-only"`, `broker submit` is a pre-flight
Expand Down
35 changes: 0 additions & 35 deletions .codex/skills/aethyme/references/graph-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,38 +145,3 @@ Two ways the graph can quietly disagree with the source you are reading:
2. **The extraction is incomplete.** Unresolved edges and absent callers are
expected in the coverage gaps listed above. Absence of evidence in the graph
is not evidence of absence in the code.

## Task Scope And Anchors

Use task commands when the user asks "where should I work?", "what files are in
scope?", or "what should I inspect next?" and the initial Explore answer is not
enough.

```bash
aethyme task anchors --repo "$REPO" --task "<task>" --json-output
aethyme task scope --repo "$REPO" --task "<task>" --json-output
aethyme task next --repo "$REPO" --task "<task>" --json-output
```

Read reasons and risks before expanding scope. A file with a clear reason beats
a larger list with weak evidence.

## Context Packs

Use a pack when you need a compact prompt-ready bundle instead of reading many
files manually.

```bash
aethyme task context --repo "$REPO" --task "<task>" --json-output
aethyme task pack --repo "$REPO" --task "<task>" --json-output
```

Inspect selected files, selected symbols, snippets, and token estimates. If a
pack is too large, narrow the task or anchor before asking for a larger pack.

## Verification Discipline

Graph/task output is a candidate selector, not a substitute for reading code.
After a graph or task command, verify with targeted file reads or symbol grep
against the returned paths. Avoid raw `rg --files`, broad `find`, or
repo-wide grep unless Aethyme returned no usable candidates.
4 changes: 2 additions & 2 deletions .codex/skills/repo-onboarding/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ description: Use when starting work in an unfamiliar repository, when the task a

## Freshness

- Source digest: `1cc729348eeead667dcc0ac274bc2e9cb91df1799a0a670316fd6e3abacd14f5`
- Tracked source files: `539`
- Source digest: `50b057d5f9ff1851a21d4b1ecac1b9454323cb851d29d19edf383d3c51415671`
- Tracked source files: `540`
- Overrides applied: `False`
- Sections generated: `repo, workspaces, primary_workspace, commands, areas, entrypoints, caution_zones, generated_paths, dangerous_paths, navigation_recipes, summon, freshness`
5 changes: 5 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ __pycache__/
# aethyme-broker:begin (managed block — do not edit inside)
.aethyme/broker.db*
.aethyme/logs/
.aethyme/locks/
.aethyme/reports/
.aethyme/run/
.aethyme/worktrees/
Expand All @@ -56,4 +57,8 @@ __pycache__/
.aethyme/generated/experience-status.json
.aethyme/generated/experience-status.md
.aethyme/generated/experience-telemetry.jsonl
.aethyme/reviews/
.aethyme/worktree-sizes.json
.aethyme/gc-journal.json
.aethyme/gc.lock
# aethyme-broker:end
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<!-- AETHYME:BEGIN generated -->
# Agent Instructions
<!-- AETHYME-GENERATED: version=0.8.15; policy-sha256=84b3ac88b19e9336e3dc5187a15a48822d1a12c5ce764f6758b216792593f7f3 -->
<!-- AETHYME-GENERATED: version=0.8.23; policy-sha256=ebcafce816f060cc343daa82675421f2a19781d4175918aa596ba0392213bfc6 -->

Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json`
(policy) or `.aethyme/overrides/onboarding.json` (orientation), then run
Expand Down Expand Up @@ -38,6 +37,8 @@ read it first. Leases, gates, advisories and recovery: `references/broker.md`.
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.
Read code in a session worktree, not the main checkout: it trails
`aethyme/integration` by design, and Explore flags answers from a stale tree.

## Commits

Expand All @@ -53,4 +54,3 @@ Load the Aethyme skill: `.claude/skills/aethyme/SKILL.md` (Codex:
GitHub coordination, publication, recovery), `policy.md` (commit format,
branch and review practice, verifying these files), `graph-task.md` and
`dead-code.md`.
<!-- AETHYME:END generated -->
6 changes: 3 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<!-- AETHYME:BEGIN generated -->
# Agent Instructions
<!-- AETHYME-GENERATED: version=0.8.15; policy-sha256=84b3ac88b19e9336e3dc5187a15a48822d1a12c5ce764f6758b216792593f7f3 -->
<!-- AETHYME-GENERATED: version=0.8.23; policy-sha256=ebcafce816f060cc343daa82675421f2a19781d4175918aa596ba0392213bfc6 -->

Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json`
(policy) or `.aethyme/overrides/onboarding.json` (orientation), then run
Expand Down Expand Up @@ -38,6 +37,8 @@ read it first. Leases, gates, advisories and recovery: `references/broker.md`.
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.
Read code in a session worktree, not the main checkout: it trails
`aethyme/integration` by design, and Explore flags answers from a stale tree.

## Commits

Expand All @@ -53,4 +54,3 @@ Load the Aethyme skill: `.claude/skills/aethyme/SKILL.md` (Codex:
GitHub coordination, publication, recovery), `policy.md` (commit format,
branch and review practice, verifying these files), `graph-task.md` and
`dead-code.md`.
<!-- AETHYME:END generated -->
Loading