AgentsStructure 🚀

Enterprise-grade Governance & Multi-Agent Concurrency Orchestrator

AgentsStructure is a specialized CLI tool designed for large-scale, distributed AI development. It synchronizes file access across multiple AI agents (Cursor, Claude, Copilot, Antigravity) ensuring state integrity and governance compliance.

✨ Features

• 🤖 Universal AI Support: Deep integration with Cursor, Claude, JetBrains, and more.
• ⚡ Gemini 2.5 Flash Powered: Automatically generates architecture and governance rules from a Statement of Work (SOW).
• 🔐 Concurrency Locking: Atomic file locks with a robust queuing system for multiple tools.
• 🛡️ Security & Database Governance: Automated generation of Security and DB configuration agents.

📦 Installation

npm install -g agents-structure

🚀 Quick Start

1. Set your Gemini API Key: Create a .env file in your root:

   GEMINI_API_KEY="your_api_key"

   Alternatively, export it in your shell: export GEMINI_API_KEY="..."

2. Initialize Workspace:

   agents-structure init

   Follow the wizard to generate your .ai/ governance structure.

3. Lock a File for Editing:

   agents-structure lock src/index.js --tool "Cursor" --reason "Refactoring for performance"

4. Release a Lock:

   agents-structure unlock src/index.js

📂 Structure

• .ai/agents/: Role-based governance rules.
• .ai/skills/: Shared prompt templates and utilities.
• .ai/current_task.json: Real-time traffic control for AI agents.

🛡️ Security

• Atomic Writes: Zero-corruption state management.
• Path Sanitization: Prevents locking outside project boundaries.
• Governance: Security and DB agents enforced globally.

📄 License

MIT