AIluminode: Pre-Retrieval Cognitive Orientation Tool
AIluminode is a wieldable pre-retrieval cognitive-orientation instrument that helps AI tools check contextual posture before acting, using route polarity (OPEN, PROTECT, AUDIT, DEFER, BLOCK) to reduce erroneous exploration and context bleed.
Article intelligence
Key points
- AIluminode is a wieldable pre-retrieval cognitive orientation tool emphasizing posture before retrieval.
- It uses a route polarity system (OPEN / PROTECT / AUDIT / DEFER / BLOCK) to guide contextual routing.
- The tool does not read repositories, store prompts, or own memory; it is designed to be non-invasive.
- Validation shows it reduces broad re-reading and wrong-corridor exploration, improving retrieval efficiency.
Why it matters
This matters because aIluminode is a wieldable pre-retrieval cognitive orientation tool emphasizing posture before retrieval.
Technical impact
May affect agent architecture, tool calling, workflow automation, and product integration.
Notifications You must be signed in to change notification settings
Fork 0
Star 0
BranchesTags
Open more actions menu
Folders and files
NameName
Last commit message
Last commit date
Latest commit
History
3 Commits
3 Commits
assets
assets
src/ailuminode
src/ailuminode
tests
tests
.gitignore
.gitignore
README.md
README.md
pyproject.toml
pyproject.toml
Repository files navigation
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.
About
No description, website, or topics provided.
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
No releases published
Packages 0
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Python 100.0%