AIluminode is a wieldable AI pre-retrieval cognitive-orientation instrument.
It helps AI tools check contextual posture before acting.
It uses NodAIity doctrine, but this repo is standalone.
prompt/task
→ cognitive posture trace
→ route polarity
→ next safe action
The core idea is posture before retrieval:
orientation
→ routing
→ retrieval
→ reasoning
Use
Install locally:
python -m pip install -e .
Run:
ailuminode scan "Refactor Paula EPUB source handling without touching memory save logic"Or without installation:
python -m ailuminode scan "Read airframe.epub section 5 without saving it as memory"
Output
AIluminode TRACE ailuminode_0000
ACTIVE_TERRAIN:
- source_terrain
STANCE:
bounded_source_reader
COMPASS_GUIDANCE:
- none
ROUTE_POLARITY:
- OPEN: current_prompt (declared task is the active entry point)
- OPEN: bounded_source_index (source terrain is active; use bounded source access)
- PROTECT: saved_memory (saved_memory is named under a protection/avoidance phrase)
- DEFER: vector_memory (vector_memory is not needed for this task)
- BLOCK: autonomous_crawling (AIluminode stays declared-task only)
DRIFT_RISK:
- source_terrain_mistaken_for_memory
- section_numbers_mistaken_for_chapters
NEXT_SAFE_ACTION:
List source sections or search source text before summarizing.
Route Polarity
OPEN = enter this route now
PROTECT = preserve this route; do not alter it
AUDIT = inspect as evidence before acting
DEFER = leave dormant unless explicitly reopened
BLOCK = keep closed for this task
Doctrine
Compass determines corridor truth.
AIluminode determines cognitive and retrieval posture.
AIluminode does not:
- read repositories
- store prompts
- own memory
- crawl systems
- ingest telemetry
- build dashboards
- run agents
It is wielded, read, and released.
illuminate
orient
release
Observed During Validation
During multi-surface debugging and architecture work, AIluminode-style orientation reduced broad rereading and wrong-corridor exploration by establishing contextual posture before action.
Observed benefits included:
- faster orientation in layered projects
- fewer accidental dives into unrelated terrain
- clearer distinction between active, blocked, protected, and deferred routes
- more surgical inspection of likely target areas
- reduced context bleed during retrieval-heavy tasks
The instrument is intentionally lightweight:
prompt in
→ orientation trace out
AIluminode does not own memory, crawl repositories, or persist context. It is designed as a wieldable pre-retrieval cognitive-orientation instrument.
Keywords
AI orientation
pre-retrieval orientation
cognitive posture
contextual routing
route polarity
retrieval discipline
bounded retrieval
drift reduction
context governance
terrain-aware systems
memory routing
active terrain
blocked terrain
protected routes
deferred routes
contextual airlocks
operational continuity
expected vs observed terrain
lightweight instrumentation
non-invasive AI tools
wieldable AI tools
Related NodAIity Tools
AIluminode pairs naturally with OhBuoy:
- OhBuoy handles operational and topological orientation.
- Compass compares expected and observed propagation.
- AIluminode handles pre-retrieval cognitive and route-posture orientation.
Together they support orientation-first systems work without becoming telemetry, memory ownership, or autonomous orchestration.
