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_USER_1="op://24ylu7osc22gtdcoic6rgjsp2m/xqpmcgcvytlmptfwwpn7kui6ei/username"
|
||||
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,
|
||||
email — its other sections are thin), Confluence CQL for precise
|
||||
lookups with known space/title.
|
||||
- Same-topic follow-ups: use `onyx answer "..." --session <last session_id>`.
|
||||
|
||||
## Subagents
|
||||
|
||||
**Default to delegating whenever the expected tool output exceeds the
|
||||
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.
|
||||
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.
|
||||
|
||||
Use the `Agent` tool. Prefer specialized agent types over `general-purpose`
|
||||
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.
|
||||
Use the `Agent` tool. Prefer specialized agent types (`Explore`, `code-reviewer`, `Plan`, etc.) over `general-purpose` when one fits.
|
||||
|
||||
### Behavioral tier (MANDATORY — always set)
|
||||
|
||||
|
|
@ -46,21 +28,15 @@ Prefix every `Agent` prompt with one of:
|
|||
|
||||
### Model selection (override only when needed)
|
||||
|
||||
Resolution order: explicit `model` param → agent type frontmatter → parent
|
||||
inheritance. (`fork` always runs on the parent model; an override is ignored.)
|
||||
Resolution order: explicit `model` param → agent type frontmatter → parent inheritance.
|
||||
|
||||
1. **Don't override specialized agent types** (`Explore`, `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.
|
||||
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.
|
||||
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 Opus parent: set `model: sonnet`** — avoid paying Opus rates for routine subagent work.
|
||||
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.
|
||||
|
||||
### Context hygiene
|
||||
|
||||
- Prefer parallel `Explore` calls over sequential `general-purpose` sessions;
|
||||
spawn independent agents in a single message so they run concurrently.
|
||||
- Once delegated, don't duplicate: never run the same search yourself while
|
||||
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.
|
||||
- Prefer parallel `Explore` calls over sequential `general-purpose` sessions.
|
||||
- Don't reuse `task_id` for fresh lookups; start new to keep prompts tiny.
|
||||
- Summarize subagent findings in the main thread to keep the terminal clean.
|
||||
|
|
|
|||
|
|
@ -108,10 +108,6 @@ credentials or customer-personal data.
|
|||
- Write notes that answer a question, not headlines. Include the concrete
|
||||
numbers, the error message verbatim, and the fix. A note that says "there
|
||||
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
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue