GitHub - SuperHeroesAreReal/AIluminode · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
SuperHeroesAreReal
AIluminode
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>3 Commits<br>3 Commits
assets
assets
src/ailuminode
src/ailuminode
tests
tests
.gitignore
.gitignore
README.md
README.md
pyproject.toml
pyproject.toml
View all files
Repository files navigation
AIluminode
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<br>→ cognitive posture trace<br>→ route polarity<br>→ next safe action
The core idea is posture before retrieval:
orientation<br>→ routing<br>→ retrieval<br>→ 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:<br>- source_terrain
STANCE:<br>bounded_source_reader
COMPASS_GUIDANCE:<br>- none
ROUTE_POLARITY:<br>- OPEN: current_prompt (declared task is the active entry point)<br>- OPEN: bounded_source_index (source terrain is active; use bounded source access)<br>- PROTECT: saved_memory (saved_memory is named under a protection/avoidance phrase)<br>- DEFER: vector_memory (vector_memory is not needed for this task)<br>- BLOCK: autonomous_crawling (AIluminode stays declared-task only)
DRIFT_RISK:<br>- source_terrain_mistaken_for_memory<br>- section_numbers_mistaken_for_chapters
NEXT_SAFE_ACTION:<br>List source sections or search source text before summarizing.
Route Polarity
OPEN = enter this route now<br>PROTECT = preserve this route; do not alter it<br>AUDIT = inspect as evidence before acting<br>DEFER = leave dormant unless explicitly reopened<br>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<br>orient<br>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<br>→ 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<br>pre-retrieval orientation<br>cognitive posture<br>contextual routing<br>route polarity<br>retrieval discipline<br>bounded retrieval<br>drift reduction<br>context governance<br>terrain-aware systems<br>memory routing<br>active terrain<br>blocked terrain<br>protected routes<br>deferred routes<br>contextual airlocks<br>operational continuity<br>expected vs observed terrain<br>lightweight instrumentation<br>non-invasive AI tools<br>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
stars
Watchers
watching
Forks
forks
Report...