---
uid: how-to-guides
description: "Each guide shows you how to do one thing in Intent Architect, in a short set of steps."
---

# How-to guides

Each guide here shows you how to do one thing in Intent Architect, in a short set of steps.

<div class="link-tiles">
<svg width="0" height="0" style="position: absolute" aria-hidden="true"><defs><linearGradient id="tile-grad" x1="0" y1="0" x2="0" y2="24" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#09C4FF"/><stop offset="1" stop-color="#0070C0"/></linearGradient></defs></svg>

## Getting Started

New to Intent Architect? Start here.

<ul>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/make-your-first-change/make-your-first-change.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M5 21V4M5 4h12l-2.5 4 2.5 4H5"/></svg><span><strong>Make your first change with the AI</strong>Open your code, ask the AI for a change, then review and commit it without leaving the app.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/use-claude-code-cursor-or-copilot/use-claude-code-cursor-or-copilot.md"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 9.5l3 2.5-3 2.5M12.5 15H17"/></svg><span><strong>Use Claude Code, Cursor or Copilot with Intent Architect</strong>Keep the coding agent you already use, from your terminal, your editor or Intent Architect's chat.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/ask-the-ai/ask-the-ai.md"><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"/><path d="M9.5 9.5a2.5 2.5 0 1 1 3.5 2.3c-.7.3-1 .9-1 1.7M12 17h.01"/></svg><span><strong>Ask the AI when you're stuck</strong>Get answers about Intent Architect and your own solution, linked to the docs they came from.</span></a></li>
</ul>

## Working with the AI

Give the agent what it needs, and get more back from it.

<ul>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/give-the-ai-context/give-the-ai-context.md"><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="3.5"/><path d="M15.5 8.5v5a2.5 2.5 0 0 0 5 0V12a8.5 8.5 0 1 0-3.4 6.8"/></svg><span><strong>Give the AI the right context, fast</strong>Point the AI at an element, a file, a screenshot or a work item instead of pasting walls of text.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/connect-an-mcp-server/connect-an-mcp-server.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M9 3v4M15 3v4M6 7h12v4a6 6 0 0 1-12 0V7zM12 17v4"/></svg><span><strong>Connect an MCP server to your chat</strong>Let the agent read and update Azure DevOps, Jira, Slack and more, in the same chat as your code.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/work-across-related-codebases/work-across-related-codebases.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M10 14a4 4 0 0 0 5.7 0l3-3a4 4 0 0 0-5.7-5.7l-1 1"/><path d="M14 10a4 4 0 0 0-5.7 0l-3 3a4 4 0 0 0 5.7 5.7l1-1"/></svg><span><strong>Work across related codebases</strong>Give the agent a frontend, a shared library or other code outside your solution to read or change.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/work-item-templates/work-item-templates.md"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="8" y="8" width="12" height="12" rx="2"/><path d="M16 8V5a1 1 0 0 0-1-1H5a1 1 0 0 0-1 1v10a1 1 0 0 0 1 1h3"/></svg><span><strong>Reuse your best prompts with Work Item templates</strong>Write a prompt you keep retyping once, and start a fresh chat from it whenever you need it.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/visual-reports/visual-reports.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 3v18h18M8 17v-5M13 17V8M18 17v-8"/></svg><span><strong>Get visual reports on your system from the agent</strong>Ask about part of your system and get diagrams, tables and links to your model and code.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/build-your-own-dashboards/build-your-own-dashboards.md"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="3" y="3" width="7" height="9" rx="1"/><rect x="14" y="3" width="7" height="5" rx="1"/><rect x="14" y="12" width="7" height="9" rx="1"/><rect x="3" y="16" width="7" height="5" rx="1"/></svg><span><strong>Build your own dashboards and dev tools with the agent</strong>Have the agent build a dashboard of your pipelines, pull requests or anything else, with live data.</span></a></li>
</ul>

## Configuring Your Workspace

Set up your workspace once so the agent can build, test and run your app.

<ul>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/set-up-tasks/set-up-tasks.md"><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"/><path d="M10 8.5l5 3.5-5 3.5z"/></svg><span><strong>Set up tasks so the agent can build, test and run your app</strong>Give the agent your build, test and run commands so it can check its own work and try your app.</span></a></li>
</ul>

## Planning and Spec-Driven Development

Choose how much structure a change needs, from a quick prompt to a spec that stays true.

<ul>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/vibe-coding-plan-mode-or-sdd/vibe-coding-plan-mode-or-sdd.md"><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"/><path d="M15.5 8.5l-2 5-5 2 2-5z"/></svg><span><strong>Vibe coding, Plan Mode or Spec-Driven Development: when to use which</strong>Prompt, plan or write a spec: pick the approach that fits the outcome you're after.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/get-it-right-with-plan-mode/get-it-right-with-plan-mode.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 6l1.5 1.5L7 5M3 12l1.5 1.5L7 11M3 18l1.5 1.5L7 17M11 6h10M11 12h10M11 18h10"/></svg><span><strong>Get it right the first time with Plan Mode</strong>Check the data model, API and screens in the plan, and comment on it before any code is written.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/turn-existing-code-into-living-specs/turn-existing-code-into-living-specs.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M14 3H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"/><path d="M14 3v6h6M9 15l2 2 4-4"/></svg><span><strong>Turn existing code into living specs</strong>Write down the rules your code already follows, back them with tests, and catch changes that break them.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/use-spec-kit-kiro-bmad-or-openspec/use-spec-kit-kiro-bmad-or-openspec.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 2l9 4.5-9 4.5-9-4.5 9-4.5zM3 11l9 4.5 9-4.5M3 16l9 4.5 9-4.5"/></svg><span><strong>Use Spec Kit, Kiro, BMAD or OpenSpec with Intent Architect</strong>Bring in the specs you have, run the framework's own commands, and see which code realizes each requirement.</span></a></li>
</ul>

## Running Agents in Parallel

Keep several agents working at once, each in its own copy of your code.

<ul>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/run-agents-in-parallel/run-agents-in-parallel.md"><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="6" cy="5" r="2"/><circle cx="6" cy="19" r="2"/><circle cx="18" cy="7" r="2"/><path d="M6 7v10M18 9a6 6 0 0 1-6 6H6"/></svg><span><strong>Run agents in parallel</strong>Hand tasks to agents that each work in their own worktree while you carry on with yours.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/stay-on-top-of-many-agents/stay-on-top-of-many-agents.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9"/><path d="M10.3 21a1.94 1.94 0 0 0 3.4 0"/></svg><span><strong>Stay on top of many agents at once</strong>See which agents are waiting on you, deal with them from the keyboard, and put away what's finished.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/split-a-big-task-across-child-chats/split-a-big-task-across-child-chats.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M14 9a2 2 0 0 1-2 2H6l-3 3V4a2 2 0 0 1 2-2h7a2 2 0 0 1 2 2z"/><path d="M18 9h1a2 2 0 0 1 2 2v10l-3-3h-6a2 2 0 0 1-2-2v-1"/></svg><span><strong>Split a big task across child chats</strong>Have the agent split a big task into chats that run side by side, then bring the results together.</span></a></li>
</ul>

## Reviewing and Shipping

Review changes with confidence and get them merged.

<ul>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/review-pull-requests/review-pull-requests.md"><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="6" cy="6" r="2"/><circle cx="6" cy="18" r="2"/><circle cx="18" cy="18" r="2"/><path d="M6 8v8M18 16V9a2 2 0 0 0-2-2h-4M14 5l-2 2 2 2"/></svg><span><strong>Review pull requests effectively</strong>Let AI review first, check the design on a diagram, and spend your time where a person is needed.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/prove-it-works/prove-it-works.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3l8 3v6c0 4.5-3.4 8-8 9-4.6-1-8-4.5-8-9V6z"/><path d="M8.5 12l2.5 2.5 4.5-5"/></svg><span><strong>Open pull requests that prove they work</strong>Have the agent prove its change with your tests, an AI review and your running app, then open the PR.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/classify-your-codebase/classify-your-codebase.md"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 4v7l10 10 8-8L11 3H4a1 1 0 0 0-1 1z"/><circle cx="7.5" cy="7.5" r="1.5"/></svg><span><strong>Classify your codebase so reviews focus on what matters</strong>Tag your code by purpose and review importance, so you know which files in a large change to read first.</span></a></li>
<li><a href="https://docs.intentarchitect.com/docs-md/how-to-guides/resolve-merge-conflicts-with-ai/resolve-merge-conflicts-with-ai.md"><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="6" cy="5" r="2"/><circle cx="6" cy="19" r="2"/><circle cx="18" cy="12" r="2"/><path d="M6 7v10M6 7c0 3 3 5 10 5"/></svg><span><strong>Resolve merge conflicts with AI</strong>Hand a merge, rebase or pull request update that stopped on conflicts to the agent to finish.</span></a></li>
</ul>

</div>
