harnez-advisor
Reuse compatible advisor sessions across supported agent tools using prose requests
Use this skill when asked to reuse an advisor session across supported agent tools.
The interface is prose-first: interpret the request and state the plan before acting. Identify, when supplied, the target agent or harness, session ID, project or repository, advisor task, model, and desired effort. Do not invent missing values.
Reuse a session only through that harness's native resume, continue, or fork mechanism, and only when the agent family and version, model and effort where relevant, project identity, instruction and permission context, advisor role, task scope, and session validity all agree. A Harnez telemetry session ID is for correlation; it is not a provider resume ID. Never choose a provider session by recency or by matching a Harnez ID.
Prefer advisors already working in this session, context, project, or feature. Treat unrelated or random advisor sessions as poor candidates unless the request explicitly identifies them.
Advisor lifecycle is decided by the orchestrator. Track when an advisor was last used and whether its project, feature, role, model, instructions, and permissions still match. Reuse a recent matching advisor directly. If a matching advisor is stale, ask it to compact its context before resuming so later requests can use a smaller summary while retaining relevant memory. Start a fresh advisor when the scope is unrelated or compatibility is uncertain. Staleness is a signal for compaction, not an automatic rejection.
After requesting compaction, confirm that the advisor returned a concise retained-context summary. Where token data is available, compare the next request's input and cached-input counts with the pre-compaction turn; do not claim savings from compaction without that evidence.
If a critical value is missing, mismatched, unsupported, expired, or ambiguous, explain why and use a fresh advisor session when the request permits it. Low reasoning is the default only where the harness supports it; report when it cannot be honored.
Current capability guidance:
- Claude: use the installed CLI's native resume, continue, or fork behavior when exposed.
- Codex: resume by the native session ID; local rollout metadata may provide input, cached-input, output, reasoning, and total token counts. The installed CLI's
exec/resumesubcommands take-m/--modelbut no dedicated effort/reasoning flag; set it via-c model_reasoning_effort=<level>instead, and verify the exact key againstcodex exec --helpand~/.codex/config.toml, since both can change across versions. Resolve a named model alias (e.g. a user's own "fast"/"deep" shorthand) by checking that user's~/.codex/config.tomlmodel tables — never assume a name maps to a fixed model ID. - AGY and Gemini: use the specific installed harness's continue or resume behavior when available. Do not assume AGY and Gemini have the same session interface.
- Prime: report unsupported and use a fresh fallback while no Prime executable or session API is available; use native reuse once that capability exists.
Label evidence as measured, reported, estimated, or unknown. Cached input is not the same as saved tokens or money: claim savings only when a comparable fresh control exists. Do not persist prompts, transcripts, credentials, session IDs, or arbitrary command output in the repository.
There are no portable skill flags. Treat requests such as /harnez-advisor reuse <plain request> as prose and pass the interpreted intent to the native harness. A future harnez advisor reuse --flags command may provide a machine-readable interface; do not claim it exists yet.
- Content
- file-backed
- License:
- AGPL-3.0-or-later
- Origin
- first-party
- Source:
- docs/commands/HarnezAdvisor.md
- Source revision
4e3b8d592416fbf93a2af218882c1abef78faed6- Requires
- Targets
- codex, claude
- Invocation
- /harnez-advisor
Related skills
- docup — Review and update bounded repository documentation by category (testing, architecture)
- domain-modeling — Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.
- evergreen — Create/update evergreen docs and issue files for the current session
- grill-with-docs — A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.