{"id":42009140,"url":"https://github.com/ashishop/arc-protocol","last_synced_at":"2026-01-28T04:27:41.744Z","repository":{"id":334222101,"uuid":"1139380718","full_name":"AshishOP/arc-protocol","owner":"AshishOP","description":"🚀 High-discipline agentic workflow for AI-assisted development. Analyze, Run, Confirm (ARC) project execution with persistent context.","archived":false,"fork":false,"pushed_at":"2026-01-26T00:48:56.000Z","size":20346,"stargazers_count":37,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-26T15:52:16.717Z","etag":null,"topics":["ai-agent","antigravity","automation","claude-code","workflow"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AshishOP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-21T22:13:38.000Z","updated_at":"2026-01-26T12:10:36.000Z","dependencies_parsed_at":"2026-01-27T03:00:37.119Z","dependency_job_id":null,"html_url":"https://github.com/AshishOP/arc-protocol","commit_stats":null,"previous_names":["ashishop/arc-protocol"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/AshishOP/arc-protocol","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishOP%2Farc-protocol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishOP%2Farc-protocol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishOP%2Farc-protocol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishOP%2Farc-protocol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AshishOP","download_url":"https://codeload.github.com/AshishOP/arc-protocol/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishOP%2Farc-protocol/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28798585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T01:07:07.743Z","status":"online","status_checked_at":"2026-01-27T02:00:07.755Z","response_time":168,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-agent","antigravity","automation","claude-code","workflow"],"created_at":"2026-01-26T02:17:44.099Z","updated_at":"2026-01-27T03:00:47.604Z","avatar_url":"https://github.com/AshishOP.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ARC Protocol v2.1 (Technical Preview)\n\n```text\n   █████╗ ██████╗  ██████╗ \n  ██╔══██╗██╔══██╗██╔════╝ \n  ███████║██████╔╝██║      \n  ██╔══██║██╔══██╗██║      \n  ██║  ██║██║  ██║╚██████╗ \n  ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ \n   ANALYZE. RUN. CONFIRM.\n```\n\n![ARC Dashboard](assets/Dashboard.png)\n\n## 🧩 What is ARC?\nARC is a system that prevents AI-assisted coding from becoming sloppy. In simpler terms: it's a local development workflow that lets multiple AI agents work together to build a project without losing the \"big picture.\"\n\nMost AI tools just \"wing it\" by looking at one file at a time and hoping for the best. ARC is different. It’s a coordination layer that forces the AI to work like a pro. It breaks the job down: it **Analyzes** your whole codebase, **Runs** the task using specialized \"expert\" agents (like a Researcher, a Coder, and an Auditor), and **Confirms** that everything actually works before it calls it a day. \n\nIt’s not magic—it’s just a strict set of guardrails that keep your AI focused and your code clean.\n\n---\n\n\n\u003e **Why I Built This:**\n\u003e I'm a developer, not a \"Prompt Engineer.\" I got tired of AI writing code that broke two days later because it forgot my file structure.\n\u003e\n\u003e Other tools try to be \"Magic Employees\" that run your whole company. ARC is different. It's a **Managed Context Protocol**. It forces the AI to check `CONTRACTS.md` before it commits a single line of code. No magic. Just guardrails.\n\n---\n\n## ⚡ Quick Start\n\n### 1. Installation\nYou need **Python 3.10+** (for the Core Logic) and **Node.js 18+** (for the Gemini Auth Bridge). No API Key required (we use your Google account).\n\n```bash\n# 1. Initialize the environment\npython3 setup_arc.py\n\n# 2. Login to Gemini (One time only)\nnpm install -g @google/generative-ai\ngemini login\n\n# 3. Connect your IDE\n# Copy the config from docs/INTEGRATIONS.md to your MCP settings.\n```\n[👉 Comprehensive Integrations Guide](docs/INTEGRATIONS.md)\n\n---\n\n\u003e 💡 **A Quick Tip on Slash-Commands:**\n\u003e Don't reach for your terminal when you see things like `/arc-new` or `/arc-plan`. These aren't shell scripts; they're **trigger phrases** for your AI.\n\u003e\n\u003e Just type them into your chat sidebar (in Claude, Windsurf, or Antigravity) once you've connected ARC. Your AI sees the slash-command, grabs the right tool from the protocol, and starts the automation for you.\n\n---\n\n## 🏎️ Tutorial: Build a To-Do App in 5 Minutes\n\nSee it in action. Open your AI editor (Claude/Windsurf/Antigravity) and type:\n\n1.  **\"Initialize a new project. Run `/arc-new`.\"**\n    *   *AI asks:* \"What are we building?\"\n    *   *You say:* \"A simple Python CLI To-Do app.\"\n2.  **\"Okay, let's build Phase 1. Run `/arc-plan`.\"**\n    *   *AI acts:* It reads `PROJECT.md`, checks for existing code (none), and drafts a plan: \"Create file `todo.py`, Add `add_task` function...\"\n3.  **\"Looks good. Run `/arc-execute`.\"**\n    *   *AI acts:* It spawns background agents. You watch the dashboard.\n        *   `Research-Agent` checks `argparse` docs.\n        *   `Build-Agent` writes the `.py` file.\n        *   `Audit-Agent` checks for PEP8 violations.\n4.  **\"Verify it works. Run `/arc-verify`.\"**\n    *   *AI acts:* It runs the script and confirms tasks can be added.\n\n**Result:** You end up with a working app driven entirely through the ARC workflow, with all changes written and verified on disk.\n\n---\n\n## 📖 How to Use\n\n### 🆕 Starting a New Project\nDon't write code yet. Let the ARC process structure it for you.\n1.  Initialize: **`/arc-new`**\n2.  Plan the work: **`/arc-plan`**\n3.  Build it: **`/arc-execute`**\n\n[👉 Read the full \"New Project\" Guide](HOW_IT_WORKS.md#-5-starting-a-new-project)\n\n### 🏢 Working on an Existing Codebase\nDon't let the AI guess your architecture. Map it first.\n1.  Scan the files: **`/arc-map`**\n2.  This generates a `CODEBASE_MAP.md` that teaches the agents your style.\n3.  Then proceed with planning.\n\n[👉 Read the full \"Existing Project\" Guide](HOW_IT_WORKS.md#-6-integrating-into-an-existing-project)\n\n### 🤖 The Workflow Commands\nWe use specific trigger words to switch modes.\n*   **`/arc-discuss`**: Brainstorm before you build.\n*   **`/arc-quick`**: Fast, one-off tasks.\n*   **`/arc-verify`**: Make sure it actually works.\n\n[👉 See all Workflow Commands](HOW_IT_WORKS.md#%EF%B8%8F-2-workflow-commands)\n\n---\n\n## 📂 Documentation\n*   **[How It Works (Deep Dive)](HOW_IT_WORKS.md)**: The internal mechanics of MCP and Gemini.\n*   **[Contracts \u0026 Rules](.arc/CONTRACTS.md)**: How we enforce code quality.\n*   **[The Toolbox](docs/TOOLS.md)**: The \"Power Tools\" behind the scenes (Enforcer, Cartographer, etc.).\n\n---\n*Open Source. MIT License.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashishop%2Farc-protocol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashishop%2Farc-protocol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashishop%2Farc-protocol/lists"}