Skip to content

Building AI agents, atomically

Revert "Merge pull request #244 from BrainBlend-AI/feat/multi-platform-ai-support"

KennyVaneetveldefecc0a02a12f
diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
deleted file mode 100644
index 35235c1..0000000
--- a/.agents/plugins/marketplace.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
- "name": "brainblend-plugins",
- "interface": {
- "displayName": "BrainBlend AI Plugins"
- },
- "plugins": [
- {
- "name": "atomic-agents",
- "source": {
- "source": "local",
- "path": "../../.claude-plugin/atomic-agents"
- },
- "policy": {
- "installation": "AVAILABLE"
- },
- "category": "Development"
- }
- ]
-}
diff --git a/.claude-plugin/atomic-agents/.codex-plugin/plugin.json b/.claude-plugin/atomic-agents/.codex-plugin/plugin.json
deleted file mode 100644
index 6e361f1..0000000
--- a/.claude-plugin/atomic-agents/.codex-plugin/plugin.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
- "name": "atomic-agents",
- "version": "2.0.1",
- "description": "Skills for building, scaffolding, understanding, and auditing applications with the Atomic Agents Python framework.",
- "author": {
- "name": "BrainBlend AI",
- "email": "[email protected]"
- },
- "homepage": "https://github.com/BrainBlend-AI/atomic-agents",
- "repository": "https://github.com/BrainBlend-AI/atomic-agents",
- "license": "MIT",
- "keywords": ["atomic-agents", "ai-agents", "llm", "pydantic", "instructor", "multi-agent", "orchestration"],
- "interface": {
- "displayName": "Atomic Agents",
- "shortDescription": "Build modular AI agents with Pydantic and Instructor.",
- "longDescription": "Progressive-disclosure reference for schemas, agents, tools, context providers, prompts, orchestration, memory, hooks, providers, project structure, and testing — plus a new-app scaffolder.",
- "developerName": "BrainBlend AI",
- "category": "Development",
- "websiteURL": "https://github.com/BrainBlend-AI/atomic-agents"
- },
- "skills": "./skills/"
-}
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 1039779..667964d 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -15,7 +15,7 @@
"name": "BrainBlend AI",
"email": "[email protected]"
},
- "source": "./.claude-plugin/atomic-agents",
+ "source": "./claude-plugin/atomic-agents",
"category": "development",
"homepage": "https://github.com/BrainBlend-AI/atomic-agents",
"repository": "https://github.com/BrainBlend-AI/atomic-agents",
diff --git a/.codex/skills/release b/.codex/skills/release
deleted file mode 120000
index 702faf6..0000000
--- a/.codex/skills/release
+++ /dev/null
@@ -1 +0,0 @@
-../../.claude/skills/release
\ No newline at end of file
diff --git a/.continue/rules/atomic-agents.md b/.continue/rules/atomic-agents.md
deleted file mode 100644
index 3e100e1..0000000
--- a/.continue/rules/atomic-agents.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-name: Atomic Agents
-alwaysApply: true
----
-
-Atomic Agents monorepo — lightweight Python framework for modular AI agents (Pydantic + Instructor).
-
-## Structure
-- `atomic-agents/` — core library (`pip install atomic-agents`)
-- `atomic-assembler/` — CLI tool
-- `atomic-examples/` — example projects
-- `atomic-forge/` — downloadable tools
-
-## Development
-- Package manager: uv (never pip)
-- `uv sync` — install deps
-- `uv run pytest --cov=atomic_agents atomic-agents` — tests
-- `uv run black atomic-agents atomic-assembler atomic-examples atomic-forge` — format (line-length=127)
-- `uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge` — lint
-
-## Conventions
-- Python 3.12+, Black + Flake8, line-length=127
-- Pydantic v2 (`BaseIOSchema`) for all agent I/O — no raw dicts
-- Branch: `main` only
-- Composition over inheritance; all control flow in Python
diff --git a/.gemini/settings.json b/.gemini/settings.json
deleted file mode 100644
index d7fa0c0..0000000
--- a/.gemini/settings.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
- "context": {
- "fileName": ["GEMINI.md"]
- }
-}
diff --git a/.gemini/skills/release b/.gemini/skills/release
deleted file mode 120000
index 702faf6..0000000
--- a/.gemini/skills/release
+++ /dev/null
@@ -1 +0,0 @@
-../../.claude/skills/release
\ No newline at end of file
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
deleted file mode 100644
index d3f4f4a..0000000
--- a/.github/copilot-instructions.md
+++ /dev/null
@@ -1,20 +0,0 @@
-Atomic Agents monorepo — lightweight Python framework for modular AI agents built on Pydantic + Instructor.
-
-## Structure
-- `atomic-agents/` — core library (`pip install atomic-agents`)
-- `atomic-assembler/` — CLI (`atomic` command)
-- `atomic-examples/` — runnable example projects
-- `atomic-forge/` — downloadable tools (not bundled; users copy what they need)
-
-## Development
-- **Package manager**: uv only — never use pip directly
-- `uv sync` — install deps
-- `uv run pytest --cov=atomic_agents atomic-agents` — run tests
-- `uv run black atomic-agents atomic-assembler atomic-examples atomic-forge` — format (line-length=127)
-- `uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge` — lint
-
-## Conventions
-- Python 3.12+, Black + Flake8, line-length=127
-- Pydantic v2 (`BaseIOSchema`) for all agent I/O — no raw dicts
-- Branch: `main` only
-- Composition over inheritance; no hidden abstractions; all control flow in Python
diff --git a/.kiro/steering/atomic-agents.md b/.kiro/steering/atomic-agents.md
deleted file mode 100644
index 0873021..0000000
--- a/.kiro/steering/atomic-agents.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-inclusion: always
----
-
-Atomic Agents monorepo — lightweight Python framework for modular AI agents (Pydantic + Instructor).
-
-## Structure
-- `atomic-agents/` — core library (`pip install atomic-agents`)
-- `atomic-assembler/` — CLI tool
-- `atomic-examples/` — example projects
-- `atomic-forge/` — downloadable tools
-
-## Development
-- Package manager: uv (never pip)
-- `uv sync` — install deps
-- `uv run pytest --cov=atomic_agents atomic-agents` — tests
-- `uv run black atomic-agents atomic-assembler atomic-examples atomic-forge` — format (line-length=127)
-- `uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge` — lint
-
-## Conventions
-- Python 3.12+, Black + Flake8, line-length=127
-- Pydantic v2 (`BaseIOSchema`) for all agent I/O — no raw dicts
-- Branch: `main` only
-- Composition over inheritance; all control flow in Python
diff --git a/.opencode/package.json b/.opencode/package.json
deleted file mode 100644
index a6e93a3..0000000
--- a/.opencode/package.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
- "dependencies": {
- "@opencode-ai/plugin": "latest"
- }
-}
diff --git a/.opencode/plugins/atomic-agents.ts b/.opencode/plugins/atomic-agents.ts
deleted file mode 100644
index 6956607..0000000
--- a/.opencode/plugins/atomic-agents.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-import type { Plugin } from "@opencode-ai/plugin"
-
-export const AtomicAgentsPlugin: Plugin = async (_ctx) => {
- return {
- "shell.env": async (_input, output) => {
- output.env.UV_PROJECT_ENVIRONMENT = ".venv"
- },
- }
-}
diff --git a/.windsurf/rules/atomic-agents.md b/.windsurf/rules/atomic-agents.md
deleted file mode 100644
index a9a97ab..0000000
--- a/.windsurf/rules/atomic-agents.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-trigger: always_on
----
-
-Atomic Agents monorepo — lightweight Python framework for modular AI agents (Pydantic + Instructor).
-
-## Structure
-- `atomic-agents/` — core library (`pip install atomic-agents`)
-- `atomic-assembler/` — CLI tool
-- `atomic-examples/` — example projects
-- `atomic-forge/` — downloadable tools
-
-## Development
-- Package manager: uv (never pip)
-- `uv sync` — install deps
-- `uv run pytest --cov=atomic_agents atomic-agents` — tests
-- `uv run black atomic-agents atomic-assembler atomic-examples atomic-forge` — format (line-length=127)
-- `uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge` — lint
-
-## Conventions
-- Python 3.12+, Black + Flake8, line-length=127
-- Pydantic v2 (`BaseIOSchema`) for all agent I/O — no raw dicts
-- Branch: `main` only
-- Composition over inheritance; all control flow in Python
diff --git a/GEMINI.md b/GEMINI.md
deleted file mode 100644
index 43c994c..0000000
--- a/GEMINI.md
+++ /dev/null
@@ -1 +0,0 @@
diff --git a/README.md b/README.md
index 06fe03d..8085450 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,6 @@ Built on [Instructor](https://github.com/jxnl/instructor) and [Pydantic](https:/
- [Atomic Forge \& CLI](#atomic-forge--cli)
- [Running the CLI](#running-the-cli)
- [Project Structure](#project-structure)
- - [AI Coding Assistant Support](#ai-coding-assistant-support)
- [Provider \& Model Compatibility](#provider--model-compatibility)
- [Contributing](#contributing)
- [License](#license)
@@ -376,24 +375,6 @@ To install all workspace packages (examples and tools):
uv sync --all-packages
```
-## AI Coding Assistant Support
-
-Atomic Agents ships with first-class support for all major AI coding assistants. Project context lives in [`AGENTS.md`](AGENTS.md) — the universal standard read natively by most tools — with thin per-tool configs layered on top.
-
-| Tool | Config | Plugin / Skills |
-|------|--------|-----------------|
-| **Claude Code** | `CLAUDE.md` → `@AGENTS.md` | [BrainBlend marketplace](https://github.com/BrainBlend-AI/atomic-agents) or [Anthropic official marketplace](https://github.com/anthropics/claude-plugins-official) |
-| **Codex** | `AGENTS.md` (native) | `.agents/plugins/marketplace.json` |
-| **Gemini CLI** | `GEMINI.md` → `@AGENTS.md`, `.gemini/settings.json` | `.gemini/skills/` |
-| **GitHub Copilot** | `.github/copilot-instructions.md` | — |
-| **Cursor** | `AGENTS.md` (native) | `.claude/skills/` (native legacy path) |
-| **Windsurf** | `.windsurf/rules/atomic-agents.md` | — |
-| **Kiro** | `.kiro/steering/atomic-agents.md` | — |
-| **Continue.dev** | `.continue/rules/atomic-agents.md` | — |
-| **OpenCode** | `.opencode/plugins/atomic-agents.ts` | — |
-
-The `release` skill (for repo maintainers) is symlinked into `.gemini/skills/release` and `.codex/skills/release` from the canonical `.claude/skills/release` source.
-
## Provider & Model Compatibility
Atomic Agents depends on the [Instructor](https://github.com/jxnl/instructor) package. This means that in all examples where OpenAI is used, any other API supported by Instructor can also be used—such as Ollama, Groq, Mistral, Cohere, Anthropic, Gemini, [MiniMax](https://www.minimax.io/), and more. For a complete list, please refer to the Instructor documentation on its [GitHub page](https://github.com/jxnl/instructor).
diff --git a/AGENTS.md b/agents.md
similarity index 100%
rename from AGENTS.md
rename to agents.md
diff --git a/.claude-plugin/atomic-agents/.claude-plugin/plugin.json b/claude-plugin/atomic-agents/.claude-plugin/plugin.json
similarity index 100%
rename from .claude-plugin/atomic-agents/.claude-plugin/plugin.json
rename to claude-plugin/atomic-agents/.claude-plugin/plugin.json
diff --git a/.claude-plugin/atomic-agents/CHANGELOG.md b/claude-plugin/atomic-agents/CHANGELOG.md
similarity index 100%
rename from .claude-plugin/atomic-agents/CHANGELOG.md
rename to claude-plugin/atomic-agents/CHANGELOG.md
diff --git a/.claude-plugin/atomic-agents/LICENSE b/claude-plugin/atomic-agents/LICENSE
similarity index 100%
rename from .claude-plugin/atomic-agents/LICENSE
rename to claude-plugin/atomic-agents/LICENSE
diff --git a/.claude-plugin/atomic-agents/README.md b/claude-plugin/atomic-agents/README.md
similarity index 100%
rename from .claude-plugin/atomic-agents/README.md
rename to claude-plugin/atomic-agents/README.md
diff --git a/.claude-plugin/atomic-agents/agents/atomic-explorer.md b/claude-plugin/atomic-agents/agents/atomic-explorer.md
similarity index 100%
rename from .claude-plugin/atomic-agents/agents/atomic-explorer.md
rename to claude-plugin/atomic-agents/agents/atomic-explorer.md
diff --git a/.claude-plugin/atomic-agents/agents/atomic-reviewer.md b/claude-plugin/atomic-agents/agents/atomic-reviewer.md
similarity index 100%
rename from .claude-plugin/atomic-agents/agents/atomic-reviewer.md
rename to claude-plugin/atomic-agents/agents/atomic-reviewer.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/SKILL.md b/claude-plugin/atomic-agents/skills/framework/SKILL.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/SKILL.md
rename to claude-plugin/atomic-agents/skills/framework/SKILL.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/agents.md b/claude-plugin/atomic-agents/skills/framework/references/agents.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/agents.md
rename to claude-plugin/atomic-agents/skills/framework/references/agents.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/context-providers.md b/claude-plugin/atomic-agents/skills/framework/references/context-providers.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/context-providers.md
rename to claude-plugin/atomic-agents/skills/framework/references/context-providers.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/hooks.md b/claude-plugin/atomic-agents/skills/framework/references/hooks.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/hooks.md
rename to claude-plugin/atomic-agents/skills/framework/references/hooks.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/memory.md b/claude-plugin/atomic-agents/skills/framework/references/memory.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/memory.md
rename to claude-plugin/atomic-agents/skills/framework/references/memory.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/orchestration.md b/claude-plugin/atomic-agents/skills/framework/references/orchestration.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/orchestration.md
rename to claude-plugin/atomic-agents/skills/framework/references/orchestration.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/project-structure.md b/claude-plugin/atomic-agents/skills/framework/references/project-structure.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/project-structure.md
rename to claude-plugin/atomic-agents/skills/framework/references/project-structure.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/prompts.md b/claude-plugin/atomic-agents/skills/framework/references/prompts.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/prompts.md
rename to claude-plugin/atomic-agents/skills/framework/references/prompts.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/providers.md b/claude-plugin/atomic-agents/skills/framework/references/providers.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/providers.md
rename to claude-plugin/atomic-agents/skills/framework/references/providers.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/schemas.md b/claude-plugin/atomic-agents/skills/framework/references/schemas.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/schemas.md
rename to claude-plugin/atomic-agents/skills/framework/references/schemas.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/testing.md b/claude-plugin/atomic-agents/skills/framework/references/testing.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/testing.md
rename to claude-plugin/atomic-agents/skills/framework/references/testing.md
diff --git a/.claude-plugin/atomic-agents/skills/framework/references/tools.md b/claude-plugin/atomic-agents/skills/framework/references/tools.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/framework/references/tools.md
rename to claude-plugin/atomic-agents/skills/framework/references/tools.md
diff --git a/.claude-plugin/atomic-agents/skills/new-app/SKILL.md b/claude-plugin/atomic-agents/skills/new-app/SKILL.md
similarity index 100%
rename from .claude-plugin/atomic-agents/skills/new-app/SKILL.md
rename to claude-plugin/atomic-agents/skills/new-app/SKILL.md