Compare commits

..

No commits in common. "8db8e6a3c8bdbb6bb31b09fd79ba3b86f13c04b6" and "94bebbf0ac5f29b803d02c943873b411ed1f85b1" have entirely different histories.

3 changed files with 9 additions and 43 deletions

View file

@ -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"

View file

@ -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.

View file

@ -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