{"id":44527369,"url":"https://github.com/faidd/faidd","last_synced_at":"2026-02-14T19:01:14.323Z","repository":{"id":337157974,"uuid":"1152524403","full_name":"faidd/faidd","owner":"faidd","description":"FAIDD is a sovereign security framework designed to govern, audit, and secure the interactions of AI agents within high-integrity development environments","archived":false,"fork":false,"pushed_at":"2026-02-13T16:30:09.000Z","size":510,"stargazers_count":11,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-14T00:35:34.313Z","etag":null,"topics":["ai","ai-agents","ai-assistant","ai-workflow","aidd","bmad","bmad-method","development","faidd","framework","rust","typescript","worflows"],"latest_commit_sha":null,"homepage":"https://www.faidd.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/faidd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-08T02:08:02.000Z","updated_at":"2026-02-13T16:30:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/faidd/faidd","commit_stats":null,"previous_names":["faidd/faidd"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/faidd/faidd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faidd%2Ffaidd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faidd%2Ffaidd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faidd%2Ffaidd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faidd%2Ffaidd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faidd","download_url":"https://codeload.github.com/faidd/faidd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faidd%2Ffaidd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29452582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T15:52:44.973Z","status":"ssl_error","status_checked_at":"2026-02-14T15:52:11.208Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-assistant","ai-workflow","aidd","bmad","bmad-method","development","faidd","framework","rust","typescript","worflows"],"created_at":"2026-02-13T18:13:09.681Z","updated_at":"2026-02-14T19:01:14.302Z","avatar_url":"https://github.com/faidd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/banner%20faidd.png\" width=\"800\" alt=\"FAIDD Banner\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/faidd\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/faidd?style=flat-square\u0026color=cb3837\" alt=\"NPM Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/faidd\"\u003e\u003cimg src=\"https://img.shields.io/npm/dw/faidd?style=flat-square\u0026logo=npm\u0026color=cb3837\" alt=\"NPM Downloads\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/faidd/faidd/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/faidd/faidd?style=social\" alt=\"GitHub stars\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n# 🛡️ FAIDD: The Intelligence Encapsulation Framework\n\n**FAIDD is not a code generator. It is the Sovereign Perimeter where code is born.**\n\nMost 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.\n\n## 🧠 The Mission: Cognitive Scaffolding\n\nIn 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. \n\nFAIDD 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.\n\n---\n\n## 🚀 The Three Pillars of Sovereignty\n\n### 1. High-Fidelity Encapsulation\n\nFAIDD 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.\n\n### 2. Tactical Alignment (Bunker vs. Brain)\n\nWe enforce a strict **Physical Decoupling** of project consciousness:\n\n* **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.\n* **The Brain (`faidd/`)**: The operational command. It's where the deep analysis and architectural planning happen. It is the tactical layer of the project.\n\n### 3. Multi-Agent Mastery\n\nFAIDD 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.\n\n---\n\n## 🏗️ Technical Architecture\n\n```mermaid\ngraph TD\n    User((Architect)) --\u003e CLI[FAIDD CLI]\n    CLI --\u003e Bunker[\"🛡️ The Bunker (_faidd/)\"]\n    CLI --\u003e Brain[\"🧠 The Brain (faidd/)\"]\n    \n    subgraph \"Sovereign Layer (Immutable Context)\"\n    Bunker --\u003e Agents[\"Agents: Cognitive Mindsets\"]\n    Bunker --\u003e Rules[\"Rules: Alignment Manifests\"]\n    Bunker --\u003e Rights[\"Rights: ACL Matrix\"]\n    end\n    \n    subgraph \"Operational Layer (Strategic Context)\"\n    Brain --\u003e Analysis[\"Deep Strategic Dives\"]\n    Brain --\u003e Planning[\"Feature Blueprints\"]\n    Brain --\u003e Ledger[\"Mission Audit Trail\"]\n    end\n```\n\n---\n\n## ⚡ Quick Start: Deploy the Frame\n\nExperience the power of structured intelligence in under 10 seconds.\n\n![FAIDD Terminal Experience](assets/faidd-terminal.png)\n\n```bash\nnpx faidd\n```\n\nThis command triggers the **Sovereign Onboarding Flow**, established your workspace identity and aligning your AI environment automatically.\n\n---\n\n## 📊 Star History \u0026 Growth\n\n*The community of Architects is growing. Join the evolution.*\n\n[![Star History Chart](https://api.star-history.t9t.io/svg?repos=faidd/faidd\u0026type=Date)](https://star-history.com/#faidd/faidd\u0026Date)\n\n---\n\n## 📜 Release History\n\n| Version | Milestone | Narrative | Status |\n| :--- | :--- | :--- | :--- |\n| **v0.1.8** | [The Intelligence Singularity](./versions/v0.1.8.md) | Identity Refresh \u0026 Clean Architecture | **Current** |\n| **v0.1.7** | [Sovereign Autonomy](./versions/v0.1.7.md) | NPX Optimization \u0026 Portable Registry | Stabilized |\n| **v0.1.0** | [The Foundation](./versions/v0.1.0.md) | Initial Sovereign Scaffolding | Legacy |\n\n---\n\n## ⚖️ License\n\nFAIDD is released under the **Apache 2.0 License**. Distributed for the elite, built for the autonomous age.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaidd%2Ffaidd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaidd%2Ffaidd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaidd%2Ffaidd/lists"}