Compare commits
No commits in common. "8db8e6a3c8bdbb6bb31b09fd79ba3b86f13c04b6" and "94bebbf0ac5f29b803d02c943873b411ed1f85b1" have entirely different histories.
8db8e6a3c8
...
94bebbf0ac
3 changed files with 9 additions and 43 deletions
|
|
@ -72,9 +72,3 @@ export FORGEJO_TOKEN="op://24ylu7osc22gtdcoic6rgjsp2m/zdkxvnabf23xjnp3lwti43hmma
|
||||||
export PROXMOX_URL_1="op://24ylu7osc22gtdcoic6rgjsp2m/xqpmcgcvytlmptfwwpn7kui6ei/url"
|
export PROXMOX_URL_1="op://24ylu7osc22gtdcoic6rgjsp2m/xqpmcgcvytlmptfwwpn7kui6ei/url"
|
||||||
export PROXMOX_USER_1="op://24ylu7osc22gtdcoic6rgjsp2m/xqpmcgcvytlmptfwwpn7kui6ei/username"
|
export PROXMOX_USER_1="op://24ylu7osc22gtdcoic6rgjsp2m/xqpmcgcvytlmptfwwpn7kui6ei/username"
|
||||||
export PROXMOX_TOKEN_1="op://24ylu7osc22gtdcoic6rgjsp2m/xqpmcgcvytlmptfwwpn7kui6ei/credential"
|
export PROXMOX_TOKEN_1="op://24ylu7osc22gtdcoic6rgjsp2m/xqpmcgcvytlmptfwwpn7kui6ei/credential"
|
||||||
|
|
||||||
# ai
|
|
||||||
export VLLM_API_KEY="op://24ylu7osc22gtdcoic6rgjsp2m/ryeegxxtakfolgqqgnwtdio2ny/credential"
|
|
||||||
export GOOGLE_AI_STUDIO_API_KEY="op://24ylu7osc22gtdcoic6rgjsp2m/e225knzbmb6rxe5utr2csjphqu/credential"
|
|
||||||
export CLAUDE_VERTEX_GATEWAY_TOKEN="op://24ylu7osc22gtdcoic6rgjsp2m/gwkninymrh2a7msvsou24c3zvu/credential"
|
|
||||||
export ONYX_ADMIN_TOKEN="op://24ylu7osc22gtdcoic6rgjsp2m/rw6ccrvzirrls47g4vkjurhzm4/credential"
|
|
||||||
|
|
|
||||||
|
|
@ -11,30 +11,12 @@
|
||||||
- Two shortcuts past onyx: Thicket MCP for people lookups (role, team,
|
- Two shortcuts past onyx: Thicket MCP for people lookups (role, team,
|
||||||
email — its other sections are thin), Confluence CQL for precise
|
email — its other sections are thin), Confluence CQL for precise
|
||||||
lookups with known space/title.
|
lookups with known space/title.
|
||||||
- Same-topic follow-ups: use `onyx answer "..." --session <last session_id>`.
|
|
||||||
|
|
||||||
## Subagents
|
## Subagents
|
||||||
|
|
||||||
**Default to delegating whenever the expected tool output exceeds the
|
Spawn subagents to (a) isolate context-heavy work from the main thread, or (b) parallelize independent subtasks. Before spawning, ask: *could `Bash`/`Grep`/`Read` do this directly?* Subagents have overhead — skip the middleman for mechanical lookups.
|
||||||
conclusion the main thread actually needs** — multi-file research, log/data
|
|
||||||
analysis, doc review, broad searches, verification runs. The session context
|
|
||||||
is the scarce resource; a subagent burns its own context and returns only the
|
|
||||||
result. Work inline only for single-fact lookups where file and symbol are
|
|
||||||
already known — there, a subagent is pure overhead.
|
|
||||||
|
|
||||||
Use the `Agent` tool. Prefer specialized agent types over `general-purpose`
|
Use the `Agent` tool. Prefer specialized agent types (`Explore`, `code-reviewer`, `Plan`, etc.) over `general-purpose` when one fits.
|
||||||
when one fits:
|
|
||||||
|
|
||||||
- **`Explore`** — read-only search: *locates* code and facts (reads excerpts,
|
|
||||||
not whole files). It does not review or audit; quality judgments stay with
|
|
||||||
the parent or a dedicated reviewer.
|
|
||||||
- **`Plan`** — implementation strategy, architecture trade-offs.
|
|
||||||
- **`fork`** (`subagent_type: "fork"`) — inherits the full conversation
|
|
||||||
context, runs in the background, keeps its tool output out of the main
|
|
||||||
thread. The tool of choice for "do X with everything you already know, give
|
|
||||||
me only the outcome" — no need to re-explain state in the prompt.
|
|
||||||
- Agent types not listed as available in the session (e.g. a `code-reviewer`)
|
|
||||||
don't exist there — check the available-types list instead of guessing.
|
|
||||||
|
|
||||||
### Behavioral tier (MANDATORY — always set)
|
### Behavioral tier (MANDATORY — always set)
|
||||||
|
|
||||||
|
|
@ -46,21 +28,15 @@ Prefix every `Agent` prompt with one of:
|
||||||
|
|
||||||
### Model selection (override only when needed)
|
### Model selection (override only when needed)
|
||||||
|
|
||||||
Resolution order: explicit `model` param → agent type frontmatter → parent
|
Resolution order: explicit `model` param → agent type frontmatter → parent inheritance.
|
||||||
inheritance. (`fork` always runs on the parent model; an override is ignored.)
|
|
||||||
|
|
||||||
1. **Don't override specialized agent types** (`Explore`, `Plan`, etc.) — their frontmatter is tuned. Leave `model` off.
|
1. **Don't override specialized agent types** (`Explore`, `code-reviewer`, `Plan`, etc.) — their frontmatter is tuned. Leave `model` off.
|
||||||
2. **For `general-purpose` under an expensive parent (Opus/Fable): set `model: sonnet`** — don't pay top rates for routine subagent work.
|
2. **For `general-purpose` under an Opus parent: set `model: sonnet`** — avoid paying Opus rates for routine subagent work.
|
||||||
3. **A bigger model (`opus`)** on a subagent only when isolated context *and* reasoning beyond what the parent can easily do inline are both needed.
|
3. **`model: opus`** on a subagent only when isolated context *and* reasoning beyond what the parent can easily do inline are both needed.
|
||||||
4. **`model: haiku`** only for mechanical tasks: bulk classification, format conversion, summarizing pre-filtered text. Code-semantic work → Sonnet.
|
4. **`model: haiku`** only for mechanical tasks: bulk classification, format conversion, summarizing pre-filtered text. Code-semantic work → Sonnet.
|
||||||
|
|
||||||
### Context hygiene
|
### Context hygiene
|
||||||
|
|
||||||
- Prefer parallel `Explore` calls over sequential `general-purpose` sessions;
|
- Prefer parallel `Explore` calls over sequential `general-purpose` sessions.
|
||||||
spawn independent agents in a single message so they run concurrently.
|
- Don't reuse `task_id` for fresh lookups; start new to keep prompts tiny.
|
||||||
- Once delegated, don't duplicate: never run the same search yourself while
|
- Summarize subagent findings in the main thread to keep the terminal clean.
|
||||||
an agent is on it, and don't poll — results arrive as notifications.
|
|
||||||
- Follow-ups to an existing agent go via `SendMessage` (keeps its context);
|
|
||||||
a new `Agent` call always starts fresh — right for unrelated lookups.
|
|
||||||
- Summarize subagent findings in the main thread; the raw report is not
|
|
||||||
shown to the user, so relay what matters.
|
|
||||||
|
|
|
||||||
|
|
@ -108,10 +108,6 @@ credentials or customer-personal data.
|
||||||
- Write notes that answer a question, not headlines. Include the concrete
|
- Write notes that answer a question, not headlines. Include the concrete
|
||||||
numbers, the error message verbatim, and the fix. A note that says "there
|
numbers, the error message verbatim, and the fix. A note that says "there
|
||||||
was a problem with X" costs more time than it saves.
|
was a problem with X" costs more time than it saves.
|
||||||
- No need to economize on characters: cognee has no size limit, so write
|
|
||||||
notes comprehensively and self-contained.
|
|
||||||
- Always keep the external references and source links (Confluence, Jira,
|
|
||||||
TeamVault, ...) in the note — they matter.
|
|
||||||
|
|
||||||
## Sandbox
|
## Sandbox
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue