docs/README.md

Documentation

This folder is the canonical secondary navigation for DRIFT / INFJ Bot. Start at the repository README for a short overview and install; use this index when you want depth, operations, or definitions.

---

Choose your path

If you…	Start here
Want to run the bot and configure keys	README § Getting started — then .env.example at repo root
Want to understand one chat turn end-to-end	HOW_INFJ_BOT_WORKS.md
Understand the falsifiability / measurement claims	FALSIFIABILITY.md
Review secrets and reporting	SECURITY.md
Plan hive / observatory work	HIVE_ROADMAP.md
Browse dependency roles	DEPENDENCIES.md

---

All guides (alphabetical)

Document	Purpose
AI_MORALITY_RULES.md	Ethical constraints and refusal boundaries baked into the system.
BASELINE_REPORT.md	Snapshot metrics from evaluations (when generated).
DEPENDENCIES.md	What major packages/runtime pieces are for.
DMU_PEDI_TEST_PLAN.md	Test plan for DMU scoring and PEDI continuity validation.
DRIFT_UPGRADE_MAY_2024.md	Upgrade notes from the May 2024 hardening pass.
EDGE_PROTOCOL.md	Edge-case handling and escalation protocol.
FALSIFIABILITY.md	Falsifiable claims, measurement axes, and ablation discipline.
GLOSSARY.md	Definitions for all DRIFT-specific terms used in code and docs.
HIVE_ROADMAP.md	Direction for hive / observatory coordination features.
HOW_INFJ_BOT_WORKS.md	Architecture, data flow diagram, modules, env table, verification.
README_UPGRADE.md	Guide for upgrading between DRIFT versions.
TEST_RISKS.md	Testing caveats and risk notes.
UPGRADE_BACKLOG.md	Planned improvements backlog.

---

Recommended reading order

1. README — scope, layers, quick start
2. HOW_INFJ_BOT_WORKS.md — how prompts, memory, and plugins fit together
3. SECURITY.md — before you expose any interface or share backups
4. FALSIFIABILITY.md — what the architecture actually claims and how to verify it
5. GLOSSARY.md — terms you will see in code and chats

Internal cross-links inside HOW_INFJ_BOT_WORKS.md point to other files above when relevant.