🧩 agentic

A centralized, vendor-agnostic library for composing AI agent instructions — pick a profile, run one command, and every AI tool in your project reads the same source of truth.

---

The Problem

Without agentic

my-project/
├── CLAUDE.md
├── .github/
│   └── copilot-instr.md
├── .cursor/rules/
│   └── *.mdc
└── .gemini/
    └── systemPrompt.md

With agentic

my-project/
├── AGENTS.md                        ← source of truth
├── CLAUDE.md                        ← symlink
├── .github/
│   └── copilot-instructions.md      ← symlink
├── .gemini/
│   ├── GEMINI.md                    ← auto-discovered
│   ├── system.md                    ← symlink
│   └── skills/                      ← symlink
└── .agentic/
    ├── config.yaml                  ← locked config
    ├── profile.yaml                 ← customize per-project
    ├── mcp.yaml                     ← MCP declarations (seed source)
    ├── project-skills/              ← your custom skills
    ├── fragments/                   ← on-demand context
    ├── skills/                      ← deployed skills
    └── vendor-files/                ← generated once
        ├── claude/
        ├── copilot/
        └── gemini/

Instructions drift and contradict each other. Every new project starts from scratch. Adding a new AI tool means updating N files manually.

---

Install

curl -sSL https://raw.githubusercontent.com/soulcodex/agentic/main/install.sh | bash

Installs the agentic CLI to ~/.local/bin. Requires bash, just, yq, jq — run just setup from the library directory to check prerequisites.

---

Deploy to a project

# See what profiles are available
agentic list profiles

# Deploy — assembles AGENTS.md, generates vendor files, deploys skills
agentic deploy typescript-hexagonal-microservice ~/code/my-api claude

Run agentic sync from within any project to regenerate from the local profile.

---

Commands

agentic deploy <profile> [target] <vendors>   # full deploy pipeline
agentic compose <profile> [target]            # assemble AGENTS.md only
agentic init [target]                         # scaffold local .agentic skeleton
agentic switch [target] <vendors>             # switch active AI tool
agentic sync [target]                         # regenerate from local profile
agentic list profiles|skills|vendors          # list available resources

→ Full command reference

---

Profiles

21 ready-made profiles covering TypeScript, Go, Python, PHP — frontend SPAs, microservices, CLIs, full-stack.

→ Browse all profiles

---

Supported AI Tools

Claude, GitHub Copilot, Gemini CLI, OpenAI Codex, Opencode, Cursor (rules-only) — all from one AGENTS.md.

→ Vendor details

---

Customise

Edit .agentic/profile.yaml and run agentic sync to update your project. Edit .agentic/mcp.yaml to declare MCP servers once and seed vendor formats. Add project-specific skills in .agentic/project-skills/.

→ Customization guide · Custom rules

---

Contributing

Contributions are welcome — new fragments, profiles, and skills. See the contributing guide for authoring rules, quality checks, and commit conventions.

→ Contributing guide

---

License

MIT