Learn it. Build it. Ship it for others.
AI coding best practices for agents and editors
This repository is a guide to using AI coding tools well across editors and terminal agents. It covers prompting, context, verification, and a long list of supported tools and workflows. The practical parts live in repo files such as `CLAUDE.md`, workflow checklists, and Python scripts for checking and fixing links. That makes it useful both as a reading guide and as a source of reusable project rules and maintenance tooling.
Builders who use Claude Code, Cursor, Copilot, or Codex and want more consistent AI-assisted development.
You can use AI coding tools with clearer prompts, better context, and more reliable checks.
What it does
Universal best practices
Explains specific prompting, context sharing, and verification habits for AI-assisted coding.
Supported tools list
Maps out major AI editors, CLI agents, autonomous agents, and code completion tools.
Workflow guidance
Covers spec-driven development, context engineering, and agent review layers.
Repo maintenance scripts
Includes Python and shell scripts for link checking and markdown link fixes.
Review and checklist files
Provides workflow docs such as `GIT_WORKFLOW.md` and `PR_CHECKLIST.md` for repeatable use.
README
π AI-Powered Coding Tools: Best Practices & Mastery Guide
Last reviewed: August 24, 2026. AI coding tools change quickly; verify pricing, model availability, and enterprise controls before making production decisions.
π Table of Contents
- π‘οΈ Universal Best Practices
- π§° Supported Tools & IDEs
- π 2026 AI Development Resources
- π Best Practices & Learning Resources
π‘οΈ Universal Best Practices
The following principles apply to all AI-assisted coding tools.
They help you leverage AI effectively without sacrificing code quality, security, or architectural consistency.
1. π― Effective Prompting (The Most Critical Skill)
-
Be specific and constrained
Avoid vague prompts. Clearly describe what you want, how it should be done, and within which constraints.β "Refactor this code"
β "Refactor this function to use async/await, add input validation, and apply TypeScript generics." -
Define the expected output
Examples:- "Generate unit tests using Jest"
- "Return a Mermaid class diagram"
- "Output only the code diff, no explanation"
-
Iterate instead of over-prompting
Start simple, review the output, then refine.
AI works best in short feedback loops, not one giant prompt.
2. π Context Is Everything
AI can only produce high-quality results when it understands the full context.
-
Explicitly state technical constraints
- Frameworks (React Hooks, Spring Boot, FastAPI)
- Libraries (Zod, Prisma, Pandas)
- Internal conventions (naming, logging, error handling)
-
Reference related code Do not expect the AI to infer your architecture.
Example:
"This new endpoint must follow the same error handling pattern asUserService.ts." -
Explain intent and business logic Tell the AI why the code exists, not just what to write.
3. π‘οΈ Verification and Accountability (Non-Negotiable)
-
Never commit blindly
AI output should be treated as a draft, not final production code. -
Test everything Especially for:
- Authentication & authorization
- Data validation
- Performance-critical paths
-
AI accelerates β it does not replace expertise
If you don't fully understand the generated code, you shouldn't ship it.
π§° Supported Tools & IDEs
AI-First Code Editors
| Tool | Description |
|---|---|
| Cursor | AI-first code editor with strong full-repo context, improved picker (grouped repos, Run on picker, branch picker), Bugbot, Design Mode, Canvas, Composer with nested subagents, Cursor Router for Auto mode, iPad app, Google Workspace plugins (Gmail/Drive/Calendar), Cursor Automations with GitHub/Slack triggers and computer use, Cloud Agent Builds for fast resilient agent starts, Origin code hosting (early beta) with GitHub sync and PRs, Subscriptions for event-driven cloud agents, Custom modes from skills, subagents on isolated VMs, /goal long-lived objectives, and mid-run steering |
| Devin Desktop | AI-enhanced editor (formerly Windsurf, rebranded June 2026) with Devin Cloud integration, multi-model support (GPT-5.6, Opus 4.7, SWE-1.6), Fast/Ultra/Fusion modes, subagents (preview), refreshed UI, local/cloud handoff, shareable sanitized Devin Local conversations, a unified Customizations panel, and an Agent Command Center that follows the selected space with side-by-side agent windows and Markdown plan mode |
| Zed Editor | High-performance collaborative editor built in Rust with integrated AI assistance |
| PearAI | Open-source AI-powered code editor |
| Aide | Open-source AI-native IDE with proactive agents, built on VS Code |
| Kilo Code | Open-source VS Code extension supporting 500+ models at zero API markup, superset of Cline/Roo Code |
| Antigravity | Google's agent-first IDE with multi-agent orchestration, browser automation, and Gemini 3 Pro (free during preview) |
| Amp (Sourcegraph) | Agentic coding tool built on Sourcegraph's code search infrastructure with deep codebase graph and unconstrained token usage |
CLI-Based Coding Agents
| Tool | Description |
|---|---|
| Claude Code | CLI-based AI coding assistant with Sonnet 5, Opus 5, Fable 5, Haiku 4, extended thinking, 1M context window, and model aliases (default, best, fable, sonnet, opus, haiku, sonnet[1m], opus[1m], opusplan) |
GitHub Copilot CLI (gh copilot) | Terminal-native agentic development, now generally available |
| Codex CLI | OpenAI's CLI coding agent with GPT-5.3-Codex and sandboxed code execution |
| Gemini CLI | Google's open-source terminal coding agent with free Gemini 3 Pro access and 1M token context |
| Devin for Terminal | CLI agent with local/cloud handoff, multi-model (GPT-5.6, Opus 4.7, SWE-1.6) |
| Aider | Open-source CLI pair programmer with Git-aware edits, deep git integration |
| OpenCode | Open-source terminal AI agent (95K+ stars) supporting 75+ providers, free and privacy-first |
| Kiro CLI | AWS's spec-driven CLI agent with TDD workflow, GitLab/GitHub integration, and cloud sandboxes |
| Codename Goose | Desktop and CLI agent by Block for automating tasks using LLMs and extensions |
| SWE-agent | Princeton's autonomous agent that resolves real GitHub issues |
| Cascade (JetBrains) | JetBrains' AI coding agent for contextual assistance within IDEs |
| Wiggum CLI | Open-source agent that scans codebases, generates specs through AI interviews, and runs autonomous coding loops |
| agx | Checkpoint-based execution engine for AI coding agents with durable WakeβWorkβSleep loops across sessions |
| Plandex | AI coding agent designed for large, real-world development tasks with multi-file planning and review sandbox |
| Autohand Code CLI | Self-evolving autonomous coding agent with ReAct pattern, 40+ tools, and modular skills system |
| Warp | AI-enhanced terminal with smart command suggestions, agent mode, and collaborative workflows |
| Task Master | AI task management for agentic coding workflows; turns PRDs into sequenced tasks for Cursor, Claude Code, and other agents |
| TmuxAI | AI-powered terminal assistant that runs alongside tmux panes to execute and explain commands |
| Amazon Q Developer CLI | AWS's agentic CLI for the terminal with chat-driven coding, shell, and AWS workflows |
IDE-Integrated AI Assistants
| Tool | Description |
|---|---|
| GitHub Copilot | Real-time AI pair programmer integrated across VS Code, JetBrains, and GitHub |
| JetBrains Junie | AI coding agent in JetBrains IDEs that plans, writes, tests, and refactors |
| Cody (Sourcegraph) | AI assistant for code understanding, navigation, and generation across codebases |
| TRAE | Adaptive AI IDE by ByteDance for faster coding |
| Supermaven | Extremely fast AI code completion with 1M token context |
| Augment Code | AI coding platform with deep cross-repo codebase understanding via Context Engine |
| Tabby | Self-hosted, open-source AI coding assistant for own infrastructure |
| Roo Code | Popular open-source VS Code extension (fork of Cline) with multi-model support and autonomous coding modes |
| Continue | Open-source, pluggable AI code completion for VS Code and JetBrains |
| Blackbox AI | AI coding assistant with code completions, chat, and search across the web and codebase |
| Phind | AI search and coding assistant for instant answers and code solutions |
| StackSpot AI | Enterprise-focused AI platform for code generation and developer efficiency |
Autonomous Coding Agents
| Tool | Description |
|---|---|
| Devin | Autonomous AI software engineer (formerly Windsurf, rebranded June 2026) |
| Manus | Autonomous AI agent for project-level execution |
| OpenHands (OpenDevin) | Open-source AI software engineer for autonomous development |
| GPT Engineer | AI agent for building full applications from natural language |
| Fine | AI dev agent that understands requirements and iterates autonomously |
| Magic | AI software engineer platform that handles complex development tasks autonomously |
| Devon | AI software engineer for autonomous coding |
| Rovo Dev (Atlassian) | Atlassian's terminal coding agent for Jira and Confluence integration |
| Factory | AI platform automating repetitive coding tasks at scale |
| Cline (Claude Dev) | VS Code extension with full file system access and autonomous coding capabilities |
| PraisonAI | Multi-agent framework with 100+ LLM support and MCP integration |
| Qoder | Agentic coding platform focused on deeper reasoning |
| OpenASE | Open-source, ticket-driven software engineering platform orchestrating Claude Code, Codex, and Gemini CLI |
| SwarmClaw | Self-hosted multi-agent runtime with MCP support, 23+ LLM providers, and persistent memory |
| Codex Infinity | Autonomous coding agent that runs continuously on bare metal VPS with full root access |
| Copilot Workspace (GitHub) | Agent-powered dev environment that turns issues into code changes with plans and specs |
| Brood-box | Run coding agents (Claude Code, Codex, OpenCode) inside hardware-isolated microVMs with snapshot isolation |
| AgentsMesh | Self-hostable AI Agent Workforce Platform orchestrating multiple agents across remote workstations |
| Potpie | AI coding agent for streamlined development workflows |
| Agent Shadow Brain | AI background code analysis agent that watches codebases and provides real-time insights |
| OpenMagic | AI-powered coding toolbar injected via reverse proxy, capturing context and applying approved changes |
| Grok Build (xAI) | 8 parallel agents for code generation with multi-agent "Society of Mind" architecture |
| DeerFlow | ByteDance's research-focused AI agent, No.1 GitHub Trending Feb 2026 (25K+ stars) |
| AXME | Durable AI agent coordination with crash recovery, human approval gates, and open protocol (AXP) |
| Maestro | Open-source desktop command center for running multiple AI coding agents in parallel |
App Builders (No-Code/Low-Code)
| Tool | Description |
|---|---|
| Lovable | AI platform for building and deploying web applications |
| Bolt.new | Instant AI-driven web app generation in browser |
| v0 | AI-driven UI and full-stack prototyping tool (Vercel) |
| Replit AI | Cloud-based IDE with built-in AI and deployment |
| Create.xyz | AI-powered app creation from natural language |
| Bolt.diy | Open-source fork of Bolt.new supporting any LLM |
| Capacity | Agentic platform using Claude Code to turn ideas into full-stack web apps |
| Mage | Generate full-stack apps from natural language prompts |
| Rosebud AI | Vibe coding platform for 3D games and interactive web apps |
| Stitch (Google) | Google Labs tool using Gemini to generate multi-screen UI designs and front-end code |
| Forge | BYOK full-stack app creator with multi-stage pipeline for Next.js apps |
| Dyad.sh | Free, local, open-source AI app builder with any model and IDE integration |
| Pythagora | AI agent that builds apps through conversational interaction |
Code Completion & Plugins
| Tool | Description |
|---|---|
| Tabnine | Privacy-focused AI code completion |
| Codeium | Free AI code completion for 70+ languages and 40+ IDEs |
| JetBrains AI | Integrated AI for code completion and analysis in all JetBrains IDEs |
| Amazon Q Developer | AI assistant for code completion, debugging, and AWS integration |
| Google Code Assist | AI coding assistant for Google Cloud developers |
| Refact.ai | Open-source AI code completion and refactoring with self-hosting |
| Supermaven | Ultra-fast completions with 1M token context window |
| Continue | Open-source, pluggable AI code completion for VS Code and JetBrains |
| Visual Studio IntelliCode | Microsoft's AI code completion for Visual Studio |
| CodeGeeX | Open-source multilingual code generation model for inline completion |
Code Review & Quality
| Tool | Description |
|---|---|
| Qodo | AI code review, testing, and SDLC governance (formerly CodiumAI) |
| CodeRabbit | AI-driven contextual pull request reviews |
| Sourcery | AI code reviewer supporting 30+ languages |
| Sweep | AI agent for automating PR reviews and fixes |
| Greptile | AI bot for in-depth code review and PR analysis |
| DeepSource | Automated code review with tech debt tracking and security analysis |
| Pixee | AI bot for security-focused PR reviews and automatic fixes |
| What The Diff | AI tool for summarizing and analyzing code diffs |
| VibeDoctor | AI code health scanner for vibe-coded apps; detects hallucinated imports, phantom packages, and security issues with MCP support |
| Relay | Persistent memory for AI coding workflows; gives agents memory of what was built, what broke, and what's next |
Other AI Tools
| Tool | Description |
|---|---|
| Kiro | Spec-driven AI development environment with IDE, CLI, and web workflows; Crew open-source workspace, ChatGPT model support, and Auto model routing |
| Antigravity | Google's agent-first IDE with multi-agent orchestration and Gemini 3 Pro |
| Codex | OpenAI coding agent available in app, CLI, IDE extension, and web workflows |
| Roo Code | Popular open-source VS Code extension with multi-model support |
| Cline | VS Code extension with full file system access and autonomous coding |
| Pieces.app | AI-powered code snippet management and sharing |
| Context7 | MCP server providing up-to-date library documentation to LLMs and AI editors |
| PraisonAI | Multi-agent framework with 100+ LLM support and MCP integration |
| Open Interpreter | Open-source agent that runs code locally in response to natural language |
| OpenRouter | Unified API gateway routing to hundreds of LLMs; powers multi-model support in tools like Kilo Code and OpenCode |
| SpecStory | Captures AI coding chat history (Cursor, Copilot, Claude Code) as searchable, shareable markdown specs |
π 2026 AI Development Resources
ποΈ Current Snapshot - August 2026 (updated August 24, 2026)
Use this section as the starting point for weekly maintenance:
| Area | What changed | Source to monitor |
|---|---|---|
| Cursor | Subscriptions (Aug 19) let cloud agents monitor PRs, Slack threads, or scheduled tasks and wake when something happens β agents automatically subscribe to PRs they create and drive them to completion. Also in Aug 19: Custom modes (pin any skill as an always-on mode), subagents running on their own isolated VMs, the /goal command for long-lived objectives, and mid-run steering. Origin code hosting (Aug 17, early beta on all paid plans) lets Cursor host repos with pull requests, real-time GitHub sync, and app extensions for Vercel, Depot, and Buildkite. Cloud Agent Builds (Aug 13) boot agents into ready-to-use environments β 10x faster boots and 3x faster time to first token. Google Workspace plugins (Aug 3), Cursor for iPad on all paid plans (Jul 29), Cursor Start India plan (Jul 28), and Cursor Router for Auto mode (Jul 22) remain. | Cursor changelog |
| Devin Desktop (formerly Windsurf) | v3.8.20 (Aug 21): Agent Command Center now follows whichever space is selected, converts editor windows in place without reload, and supports any number of agent windows side by side (new devin.agentWindow.location setting). Devin Local gains a full Markdown plan file with an explicit Implement button, individually stoppable subagents, and multi-root workspace support. Devin Cloud streams live shell output into sessions and adds sidebar filtering/sorting. Windows updates now install only after explicitly clicking Restart to Update. v3.7.25 (Aug 13) and v3.7.16 (Aug 10) added shareable sanitized Devin Local conversations, reliable mid-turn revert, and the unified Customizations panel. | Devin Desktop changelog |
| Claude Code | opus now resolves to Opus 5 on the Anthropic API (requires v2.1.219+) and sonnet to Sonnet 5 (v2.1.197+); alias resolution is provider-dependent (e.g. Sonnet 4.6 on Claude Platform on AWS, Sonnet 4.5 on Bedrock/Google Cloud, Opus 4.6 on Microsoft Foundry). default clears model overrides; best uses Fable 5 where available else the latest Opus; sonnet[1m]/opus[1m] select 1M-token windows; opusplan uses Opus in plan mode then Sonnet for execution. Fable 5 remains the most capable model for tasks larger than a single sitting and may bill to usage credits with an interactive consent prompt. | Claude Code model config |
| GitHub Copilot CLI | gh copilot is now generally available for Copilot subscribers. Old github/gh-copilot extension is deprecated. | GitHub Copilot CLI GA |
| Codex | GPT-5.3-Codex available with paid ChatGPT plans across app, CLI, IDE extension, and web. | OpenAI Codex |
| Kiro | AWS's agentic IDE, now positioned around "agentic engineering": spec-driven development, automated reasoning checks on requirements, property-based tests, parallel agents, and cloud sessions in IDE and CLI. "Crew" open-source development workspace, headless CLI for CI/CD PR review and bug fixing, ChatGPT model support, and Auto mode that picks the best model per task by complexity/latency/cost. ACP-compatible, supports AGENTS.md, Skills.md, and MCP. Available as IDE, CLI, Web, and Mobile. GitLab/GitHub integration. Pro Max tier at $100/month with 5,000 credits. Based on Code OSS with VS Code settings import. | Kiro |
| Qodo | Qodo is the current name to track for CodiumAI-style code review, testing, and quality workflows. Open-source PR Agent available. | Qodo |
π AI Coding Trends 2026
The AI development landscape is evolving rapidly. Here are the key trends shaping 2026:
1. Autonomous Development Agents
- Full-Project Execution: AI agents that can plan, code, test, and deploy complete applications
- Multi-Agent Systems: Specialized agents collaborating on complex tasks (frontend, backend, DevOps)
- Self-Correction: Agents that detect and fix their own errors without human intervention
- Context Retention: Agents maintaining project context across multiple sessions and tasks
2. Context-Aware Intelligence
- Repository-Wide Understanding: AI tools that analyze entire codebases, not just open files
- Architecture Recognition: Automatic detection of patterns, dependencies, and anti-patterns
- Team Context Integration: Understanding of team conventions, coding standards, and business logic
- Cross-Project Learning: Transfer learning between similar projects and domains
3. Real-Time Collaboration
- Live AI Pair Programming: Multiple developers collaborating with AI simultaneously
- Conflict Resolution: AI-assisted merge conflict resolution and code synchronization
- Team Knowledge Sharing: AI capturing and distributing team expertise automatically
- Remote-First Development: Optimized workflows for distributed teams
4. Security-First AI
- Proactive Vulnerability Detection: AI scanning code as it's written for security issues
- Compliance Automation: Automatic generation of security documentation and compliance reports
- Privacy-Preserving AI: On-premise and local-first AI models for sensitive codebases
- Supply Chain Security: AI monitoring dependencies for vulnerabilities and license compliance
5. Performance Optimization
- Resource-Aware Coding: AI suggesting optimizations based on deployment environment constraints
- Cost Prediction: Estimating cloud costs and suggesting cost-effective alternatives
- Performance Profiling: Automatic identification of bottlenecks and optimization opportunities
- Green Computing: Energy-efficient coding patterns and resource utilization
π AI Coding Workflows 2026
Modern development methodologies optimized for AI assistance:
1. Spec-Driven Development (SDD)
- AI-First Specification: Writing detailed specifications that AI can execute directly
- Iterative Refinement: Rapid prototyping with continuous AI feedback
- Automated Documentation: AI generating documentation from specifications and code
- Test Generation: Automatic test creation from specifications
2. Context Engineering
- Systematic Context Management: Structured approach to providing AI with relevant information
- Context Templates: Reusable context patterns for different project types
- Context Validation: AI verifying it has sufficient context before proceeding
- Context Evolution: Dynamic context updates as projects progress
3. AI-Assisted Code Review
- Automated Quality Gates: AI enforcing coding standards and best practices
- Architecture Review: AI analyzing architectural decisions and suggesting improvements
- Performance Review: Automatic performance analysis of code changes
- Security Review: Continuous security assessment during development
Three-Layer Review Architecture
High-reliability teams use a tiered approach rather than relying on a single model:
- Layer 1 β Deterministic Analysis (Linter): Traditional static analysis (ESLint, Biome) for syntax and style. Don't use AI for tasks solvable with RegEx.
- Layer 2 β Logic & Semantic Validation (Agentic Review): A mid-tier agent (e.g., Copilot Reviewer) checks the PR against
PLAN.md, verifying business logic is implemented across all files. - Layer 3 β Structural & Security Audit (Expert LLM): A flagship model or provider-approved expert model performs deep security audits (race conditions, IDORs) and validates long-term architectural goals defined in
CLAUDE.md.
4. Multi-Agent Workflows
- Specialized Agent Teams: Different AI agents for frontend, backend, testing, and deployment
- Agent Orchestration: Coordinating multiple AI agents on complex tasks
- Human-Agent Collaboration: Optimal division of labor between humans and AI
- Agent Communication: Standardized protocols for agent-to-agent interaction
π§ AI Tools Comparison 2026
Comprehensive analysis of leading AI development tools:
Autonomous Development Agents
| Tool | Strengths | Best For | Limitations |
|---|---|---|---|
| Devin Enterprise | Full-stack development, complex problem solving, cloud VM execution | Complete project execution, research tasks | Requires clear specifications, high computational cost |
| Manus Pro | Multi-agent coordination, enterprise workflows | Large team projects, complex architectures | Steep learning curve, enterprise pricing |
| Claude Code | Terminal-native planning, editing, and automation with provider-specific model aliases. Fable 5 for sustained long autonomous sessions | Infrastructure as code, data processing, large refactors | Requires strong prompt discipline and usage controls |
| Cursor Agents | Parallel agents, worktrees, local/cloud/SSH environments, Design Mode, Bugbot code review | Product engineering, UI iteration, repo-scale refactors | Best value is inside Cursor workflows |
| Codex | OpenAI coding agent across app, CLI, IDE extension, and web with GPT-5.3-Codex | Multi-step coding, tests, codebase automation, security-focused work | Availability and model access vary by pla |
Files in the repo
- .claude
- .github
- scripts
- tests
- .gitignore
- CLAUDE.md
- CODE_OF_CONDUCT.md
- completion-summary.md
- CONTRIBUTING.md
- corrected-link-report.md
- GIT_WORKFLOW.md
- link-check-report.md
- maintenance-plan.md
- maintenance-report.md
- PR_CHECKLIST.md
- README-link-check.md
- README.md
Discussion (0)
Ask about usage, or say what you built with itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More tutorials & guides
Bash is all you need - A nano claude codeβlike γagent harnessγ, built from 0 to 1
A visual, example-driven guide to Claude Code β from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Specification and documentation for Agent Skills

π» vibe coding 101ο½The first course for AI-native product builders.

End-to-end, code-first tutorials for building production-grade GenAI agents. From prototype to enterprise deployment.