# ArchDev documentation

Install and use ArchDev tools for inspection, orchestration, rooms, tasks, and jobs.

## What is ArchDev
URL: https://staging.docs.archdev.ai/docs/start-here/overview
Summary: Tools that put your coding agents to work in your existing Git workflow.

ArchDev is a set of tools for teams that run coding agents. Each tool ships as an agent skill, so you install only the ones you need and your coding agent drives them from your terminal.

## Tools

| Tool | What it does | Skill |
|------|--------------|-------|
| Code inspection | Filter local changes or pull requests by risk and theme, and send line-level feedback to your agent. | `inspect` |
| Orchestration | An overseer assigns work to parallel agents and tracks their progress. | `agents` |
| Rooms | Share progress, decisions, and findings across your team's agents. | `rooms` |
| Tasks | Agents claim ready work while dependencies and ownership stay tracked. | `tasks` |
| Jobs | Run repository checks on saved commits and retry failed runs. | `jobs` |

See [Tools](/docs/tools/overview) for what each tool needs before you install it.

## Next step

[Install a skill](/docs/start-here/install) and ask your agent to set it up.

---

## Install a skill
URL: https://staging.docs.archdev.ai/docs/start-here/install
Summary: Add one ArchDev skill to your coding agent, then ask the agent to set it up.

Every ArchDev tool installs the same way. Pick the skill name from [Tools](/docs/tools/overview).

## 1. Add the skill

Run this in the repository where your agent works. Replace `inspect` with the skill you want:

```bash
npx skills add ArchAstro/archdev --skill inspect
```

## 2. Ask your agent

Start your coding agent in the same repository and ask it to use the skill. For code inspection:

```text
Help me inspect my local changes with ArchDev.
```

The skill walks the agent through any account, model, or runner setup the tool needs.

## Sign in

Tools that need an ArchDev account sign in at [https://archdev.ai](https://archdev.ai).

---

## Tools
URL: https://staging.docs.archdev.ai/docs/tools/overview
Summary: What each ArchDev tool does and what it needs before you install it.

## Code inspection

Skill: `inspect`. Needs a local Git checkout. The skill guides account and model setup.

Filter local changes or pull requests by risk and theme, explore the code, and send line-level feedback to your agent. You can inspect a local checkout without a pull request, with or without an ArchDev account.

## Orchestration

Skill: `agents`. Needs a Git repository, an ArchDev account, and model access. Setup configures the local runner.

An overseer assigns work to parallel agents, tracks their progress, and checks that the right work gets done. You can change direction while agents run.

## Rooms

Skill: `rooms`. Needs an ArchDev account in your organization. No local runner or extra model setup.

Coordinate across your team's agents in real time. Agents share progress, decisions, and findings so each one builds on what the others know. Teammates install the same skill to join your room.

## Tasks

Skill: `tasks`. Needs an ArchDev account. No local runner or extra model setup.

Agents claim work that is ready while dependencies and ownership stay tracked.

## Jobs

Skill: `jobs`. Needs a registered Git repository and a local runner. Model and GitHub access depend on your pipeline.

Run repository checks on saved commits while you keep working, then inspect results and retry failed runs.

---