138 lines
4.3 KiB
Markdown
138 lines
4.3 KiB
Markdown
# CORE Agent Instructions for GPT-5.5 (o3-class)
|
|
|
|
Read this file in full before touching any file in this repository.
|
|
CORE is a deterministic cognitive engine — not a transformer wrapper, not a
|
|
generic chatbot, not an infrastructure playground.
|
|
|
|
> **You are stateless across API sessions.** You have no persistent memory
|
|
> of prior conversations. Complete the
|
|
> [Session Start Checklist](#session-start-checklist) before any edits.
|
|
|
|
---
|
|
|
|
## Session Start Checklist
|
|
|
|
1. **Read this file in full.**
|
|
2. **Read `AGENTS.md` in full.**
|
|
3. **Read `docs/runtime_contracts.md` in full.**
|
|
4. **Run the startup guard** — enforces fresh-base and clean-tree invariants:
|
|
```bash
|
|
source scripts/agent_startup.sh
|
|
```
|
|
For a PR-resume task: `CODEX_ALLOW_NON_MAIN_BASE=1 source scripts/agent_startup.sh`
|
|
5. **Run the smoke suite:**
|
|
```bash
|
|
core test --suite smoke -q
|
|
```
|
|
6. **Check for a handoff doc** — read the most recent `HANDOFF-*.md` if one
|
|
exists dated within the last 3 days.
|
|
7. **State your task scope** — before editing, name the module(s) and the
|
|
invariant you will prove was not violated.
|
|
|
|
---
|
|
|
|
## Reasoning and Tool Use
|
|
|
|
GPT-5.5 (o3-level) has strong multi-step reasoning. Use it here by:
|
|
|
|
- **Reasoning through the full operator chain** before proposing edits to
|
|
algebra or field modules. Do not shortcut the math.
|
|
- **Using tool calls** to sweep import graphs and call sites before editing.
|
|
- **Stating your reasoning** about why an edit preserves versor_condition
|
|
before writing the code.
|
|
|
|
For extended thinking mode: enable it for any task touching `algebra/`,
|
|
`field/`, `vault/`, `calibration/`, or `core/cognition/`.
|
|
|
|
---
|
|
|
|
## NON-NEGOTIABLE INVARIANTS
|
|
|
|
```
|
|
❌ versor_condition(F) < 1e-6 at every runtime field state.
|
|
Fix the operator/construction boundary; do not weaken the threshold.
|
|
|
|
❌ Normalization only at:
|
|
ingest/gate.py
|
|
language_packs/compiler.py
|
|
algebra/versor.py
|
|
sensorium/*/canonical.py
|
|
session/context.py (semantic anchoring only — see CLAUDE.md)
|
|
Forbidden in: generate/stream.py, field/propagate.py, vault/store.py,
|
|
logging/telemetry layers.
|
|
|
|
❌ No cosine similarity, HNSW, ANN, or approximate recall in runtime.
|
|
Vault recall is exact and deterministic.
|
|
|
|
❌ No stochastic generation or opaque LLM fallbacks in the cognitive path.
|
|
|
|
❌ No pack mutation outside the proposal-only reviewed teaching loop.
|
|
|
|
❌ INV-21/22/23/24/29/30 (see CLAUDE.md for full text).
|
|
```
|
|
|
|
---
|
|
|
|
## GPT-5.5 Specific Cautions
|
|
|
|
GPT-5.5's code generation is fluent and fast. That fluency creates
|
|
specific risks for CORE:
|
|
|
|
- **Do not generate "helpful" utility wrappers** that centralize normalization
|
|
or add intermediate caching layers. CORE's architecture is already
|
|
explicit about where these belong.
|
|
- **Do not add type coercions** in hot-path algebra that silently
|
|
re-normalize field state.
|
|
- **Do not suggest async/concurrent refactors** to vault or algebra paths
|
|
without a full trace of the determinism contract.
|
|
- **Tool-use completions that look finished may not be** — always run the
|
|
CLI validation suite, do not assume correctness from code inspection alone.
|
|
|
|
---
|
|
|
|
## Pre-Edit Sweep Protocol
|
|
|
|
Before editing any module in `algebra/`, `field/`, `generate/`, `vault/`,
|
|
`core/cognition/`, `teaching/`, or `calibration/`:
|
|
|
|
1. Trace every import of the target module.
|
|
2. Identify all callers of the target function/class.
|
|
3. Check `evals/` and `calibration/` for tests covering the changed path.
|
|
4. Only then propose edits.
|
|
|
|
---
|
|
|
|
## End-of-Session Handoff Requirement
|
|
|
|
At the end of every session, write a handoff document using the template
|
|
at `docs/handoff_template.md`. Name it:
|
|
|
|
```
|
|
HANDOFF-gpt55-YYYY-MM-DD.md
|
|
```
|
|
|
|
---
|
|
|
|
## Architecture Summary
|
|
|
|
Raw input becomes a closed versor field once; thought evolves through exact
|
|
versor transitions and CGA recall; cognition is structured as intent,
|
|
proposition graph, articulation target, deterministic realization, reviewed
|
|
memory, eval/calibration replay, and traceable evidence.
|
|
|
|
See `AGENTS.md` for the full cognitive path, key modules, and PR checklist.
|
|
|
|
---
|
|
|
|
## CLI Validation Lanes
|
|
|
|
```bash
|
|
core test --suite smoke -q
|
|
core test --suite cognition -q
|
|
core test --suite teaching -q
|
|
core test --suite packs -q
|
|
core test --suite runtime -q
|
|
core test --suite algebra -q
|
|
core test --suite full -q
|
|
core eval cognition
|
|
```
|