License NPM Version NPM Downloads GitHub stars
FAIDD is not a code generator. It is the Sovereign Perimeter where code is born.
Most AI orchestration tools (like legacy B-Mad) focus on the output—generating files, pushing commits, writing boilerplates. They treat the AI as a simple worker. FAIDD treats the AI as a strategic entity that requires a high-fidelity environment to function at peak performance.
In unorganized environments, AI agents suffer from Cognitive Fragmentation. They get lost in the noise of your root directory, misinterpret your project rules, and eventually "drift" away from the mission.
FAIDD establishes an Intelligence Frame—a physical and logical scaffold that encapsulates the agent's reasoning. By enforcing a strict hierarchy between system-level memory and project-level execution, FAIDD ensures that every token generated by the AI is aligned with your absolute strategic intent.
FAIDD wraps your development session in a Sovereign Perimeter. It's the difference between coding in a crowded street and coding in a high-tech command center. Your AI is "shielded" from project noise, allowing it to focus 100% of its attention on the task at hand.
We enforce a strict Physical Decoupling of project consciousness:
- The Bunker (
_faidd/): The immutable core. It holds the "Soul" of your project—your agents, your governance rules, and your session history. It is the system of record. - The Brain (
faidd/): The operational command. It's where the deep analysis and architectural planning happen. It is the tactical layer of the project.
FAIDD isn't built for one tool. It is the Cognitive Layer for the world's most powerful AI IDEs. Whether you use Cursor, Claude-Code, Windsurf, or local LLMs, FAIDD provides the uniform structure they need to understand their mission with zero friction.
graph TD
User((Architect)) --> CLI[FAIDD CLI]
CLI --> Bunker["🛡️ The Bunker (_faidd/)"]
CLI --> Brain["🧠 The Brain (faidd/)"]
subgraph "Sovereign Layer (Immutable Context)"
Bunker --> Agents["Agents: Cognitive Mindsets"]
Bunker --> Rules["Rules: Alignment Manifests"]
Bunker --> Rights["Rights: ACL Matrix"]
end
subgraph "Operational Layer (Strategic Context)"
Brain --> Analysis["Deep Strategic Dives"]
Brain --> Planning["Feature Blueprints"]
Brain --> Ledger["Mission Audit Trail"]
end
Experience the power of structured intelligence in under 10 seconds.
npx faidd
This command triggers the Sovereign Onboarding Flow, established your workspace identity and aligning your AI environment automatically.
The community of Architects is growing. Join the evolution.
| Version | Milestone | Narrative | Status |
|---|---|---|---|
| v0.1.8 | The Intelligence Singularity | Identity Refresh & Clean Architecture | Current |
| v0.1.7 | Sovereign Autonomy | NPX Optimization & Portable Registry | Stabilized |
| v0.1.0 | The Foundation | Initial Sovereign Scaffolding | Legacy |
FAIDD is released under the Apache 2.0 License. Distributed for the elite, built for the autonomous age.