slaguru666/AIPass
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bad08e9b03615cf5c65a35002b3e3616ca75afb9
AIPass/.aipass
T
History
AIOSAIandClaude Fable 5 222a9c8382 docs(navmap): open-source status is fleet-wide identity, not a coding footnote (Patrick ruling) 
Every agent's tier1 navmap now states AIPass is open source in the intro
and reframes the house rule as write-as-if-it-ships. External scans are
contributions, not intrusions.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YEAyLFCuo4uD934fwFxocz
2026-07-15 18:23:13 -07:00
..
.gitignore
#676 aipass: init update now refreshes AGENTS.md + prunes stale managed cruft. GAP1 — update_project synced AGENTS.md from a .aipass/project_AGENTS.md template that never existed, so AGENTS.md was a SILENT no-op on every 'aipass init update' (only CLAUDE.md, whose template exists, synced). Added the template + reconciled create/update to one source. GAP2 — update was additive-only; added a whitelist-scoped cleanup pass (_STALE_MANAGED_FILES, currently the retired aipass_global_prompt.md) that removes only positively-identified managed artifacts, logs each removal, never touches user files (registry/README/.gitignore/src/.trinity). SHIP-GAP caught in verify: .aipass/project_AGENTS.md was gitignored by the .aipass/.gitignore allowlist — added !project_AGENTS.md negation or the template would never distribute (the fix would be inert on real installs). Built by @aipass, verified by devpulse: 83 bootstrap tests green (+7), seedgo 31/31, live repro proves update emits AGENTS.md (name-interpolated) AND removes a planted cruft file.
2026-07-10 03:07:01 -07:00
hooks.json
feat(hooks): DPLAN-0244 hooks.json trust model hardening — Layer A engine gates + Layer B registry/CLI
2026-07-15 18:23:02 -07:00
project_AGENTS.md
#676 aipass: init update now refreshes AGENTS.md + prunes stale managed cruft. GAP1 — update_project synced AGENTS.md from a .aipass/project_AGENTS.md template that never existed, so AGENTS.md was a SILENT no-op on every 'aipass init update' (only CLAUDE.md, whose template exists, synced). Added the template + reconciled create/update to one source. GAP2 — update was additive-only; added a whitelist-scoped cleanup pass (_STALE_MANAGED_FILES, currently the retired aipass_global_prompt.md) that removes only positively-identified managed artifacts, logs each removal, never touches user files (registry/README/.gitignore/src/.trinity). SHIP-GAP caught in verify: .aipass/project_AGENTS.md was gitignored by the .aipass/.gitignore allowlist — added !project_AGENTS.md negation or the template would never distribute (the fix would be inert on real installs). Built by @aipass, verified by devpulse: 83 bootstrap tests green (+7), seedgo 31/31, live repro proves update emits AGENTS.md (name-interpolated) AND removes a planted cruft file.
2026-07-10 03:07:01 -07:00
project_CLAUDE.md
refactor(status): decommission entire STATUS flow — STATUS.local.md + central STATUS.md retired, replaced by local.json todos[] + dashboard count (TDPLAN-0007)
2026-06-07 21:53:24 -07:00
project_hooks.json
#620: git_gate block messages guide instead of dead-end — explain WHY git is enforced, list key drone @git commands, point to --help, show disable path (git_gate.enabled=false in .aipass/hooks.json, verified engine skips disabled hooks per-hook). Split GIT_GH_REDIRECT -> GIT_REDIRECT + GH_REDIRECT; EDIT_REDIRECT shows disable too. Init notice in project_hooks.json template, on/off in README. 6 tests, seedgo 31/31.
2026-07-10 21:30:35 -07:00
PROMPT_STYLE.md
feat(hooks): tiered prompt injection — Tier 0 kernel + Tier 1 navmap by cadence (FPLAN-0284 P2-P4, DPLAN-0214)
2026-06-18 17:48:35 -07:00
README.md
fix(memory,prompts): rollover repair + retire-for-all + seedgo #37 path cleanup
2026-06-23 16:17:10 -07:00
tier0_kernel.md
cadence fresh-context reset + aipass misroute guidance: SessionStart wiring (handler/config/setup.sh), loaders period-5, kernel+navmap aipass-exception, guide-not-crash (drone/aipass)
2026-07-07 20:02:45 -07:00
tier1_navmap.md
docs(navmap): open-source status is fleet-wide identity, not a coding footnote (Patrick ruling)
2026-07-15 18:23:13 -07:00

README.md

.aipass/ — project prompt & hook config

This folder holds the project-level prompt and hook configuration for the AIPass repo, plus the templates aipass init stamps into every new project. It is the project layer; each branch additionally has its own branch prompt at src/aipass/<branch>/.aipass/aipass_local_prompt.md.

Nothing here is dead weight. Every file is live injection, live config, or a required new-project template. Superseded files live in .archive/ (never deleted).

One prompt system, every runtime

There is one source of prompt truth — the tier files — and all runtimes inject the same content. We do not keep separate prompts per CLI. Only the delivery differs:

Runtime How the same content is delivered
Claude Code Tiered by cadence (FPLAN-0284): tier0_kernel.md every turn + tier1_navmap.md periodically + post-compaction
Codex CLI Injected once at SessionStart (no per-turn cadence): the same tier content, combined

⚠️ Migration in progress. The Codex SessionStart hook (.codex/hooks/session_start_identity.py) currently still reads the legacy aipass_global_prompt.md. @hooks is wiring it onto the tier files. Retire for one runtime = retire for all — once Codex is on the tiers, aipass_global_prompt.md is read by nothing and moves to .archive/.

Files

Live — this repo's prompt + config

File What it is
tier0_kernel.md The kernel — tiny identity + drone --help reflex + don't-get-lost rules. The always-on core, for every runtime.
tier1_navmap.md The navmap — full agent roster, framework, terminology. The periodic/fuller layer, for every runtime.
hooks.json Claude Code handler registration for this repo — which prompt/gate/notification handlers fire on which events.
PROMPT_STYLE.md The writing-style guide every prompt here follows.
.gitignore Whitelist guard — only files listed here are tracked; everything else in .aipass/ is ignored.
aipass_global_prompt.md Legacy single global — being retired. Disabled for Claude Code; Codex still reads it until its migration lands, then archived. Not the source of truth.

Templates — stamped into new projects by aipass init (bootstrap.py)

File Stamps → Notes
project_hooks.json new project's .aipass/hooks.json REQUIRED — without it a new project's hooks never fire. Mirrors the live wiring (tier0 + navmap enabled, global disabled).
project_CLAUDE.md new project's CLAUDE.md the project's Claude Code instructions.
project_global_prompt.md new project's aipass_global_prompt.md Legacy — same retirement path as the global above (new projects ship tiers-only once Codex is migrated).

(AGENTS.md — Codex's equivalent of CLAUDE.md — is generated by bootstrap.py when no project_AGENTS.md template exists, so none is kept here.)

What a new project gets (aipass init)

bootstrap.py seeds a fresh project with the tiered system:

  • tier0_kernel.md + tier1_navmap.md → the prompt content (every runtime)
  • hooks.json (from project_hooks.json) → tier0 + navmap enabled, global disabled
  • CLAUDE.md (from project_CLAUDE.md) + a generated AGENTS.md
  • aipass_global_prompt.md (from project_global_prompt.md) → legacy, retiring with the above

aipass init update backfills the tier files + refreshes hooks for existing projects.

Changing a prompt here

Run the prompt-change playbook so a change reaches every runtime and every seed path:

drone @flow create . "What changed" prompt_change

Golden rule: live ≠ seeded. Editing this folder fixes this repo only. New projects come from the project_* templates + bootstrap.py; fresh clones get their machine-local wiring from setup.sh + .claude/provider_manifest.json + cadence.py defaults. And every runtime (Claude Code + Codex) must point at the same tier content.

Archive & recovery

Superseded files move to .archive/ (never deleted — house rule). Recover from there, or from git history, any time. Current archive: the pre-tiering aipass_global_prompt.BACKUP-2026-06-09-S211.md snapshot.

Reference in New Issue View Git Blame Copy Permalink