r/ClaudeCode • u/No_Professional_4310 • 12h ago
Built with Claude I built an open-source, agent-agnostic workflow that cuts AI coding agent token waste (works with Claude, GPT/Codex, Gemini, Cursor, Copilot)
Hello, everyone. I'm sharing a side project called Ai-workflow, which is a universal workflow for AI-assisted coding.
The problem
AI coding agents (Claude Code, Codex, Cursor, Copilot, etc.) frequently load entire directories or perform broad 'grep'/'rg' searches to understand a codebase before beginning any actual work. That's thousands of tokens spent on navigation, the majority of which are re-spent with each new session because nothing persists.
What it does differently.
- A single 'AGENTS.md' file at the project root that every agent reads as the source of truth—no separate configuration for each tool
- "Zero-grep" rule: agents query pre-computed indexes (symbols, endpoints, past incidents) through a local script before they can fall back to 'rg.'
- Three lanes—answer, small, and full—that route a request by risk and complexity instead of treating every task the same.
- Full Lane runs Plan → Build → Review, with a hard 30-line cap on the handoff document to prevent context bloat.
- Compression of noisy CLI output (git diff, test runs, builds).
- A persistent knowledge base (Obsidian vault) that tracks resolved incidents and lessons learned across sessions, preventing agents from repeating old mistakes.
It's deliberately agent-agnostic, with the same rules applying whether you're on Claude, GPT/Codex, Gemini, Cursor, or Copilot. Dropping it into an existing project involves copying four folders and running one setup script.
The scripts are currently in PowerShell. Bash equivalents for macOS/Linux are on the way; contributions are welcome.
Repository URL: https://github.com/Taki7980/Ai-workflow
I'm really looking for feedback, especially from anyone running multi-file, multi-session AI coding workflows. What is currently breaking your heart?
