Agents Workspace

A lightweight AI Agent harness to handle any kind of task!

From software engineering to design, marketing, sales, finance, paid media, project management or whatever you need to be done.

Designed to create a professional workflow with dynamic team assembly of specialized agents tailored to each task, parallel execution, optimized context windows, and a self-learning cycle.

Just portable skills and a single AGENTS.md file. No hooks, plugins, or platform-specific configuration.

Quick Start

Manual

No script needed — just copy the files where they belong.

Copy AGENTS.md into your workspace:

cp AGENTS.md /path/to/your-project/

Copy skills/ to your global skills path:

Tool	Skills path
OpenCode	~/.config/opencode/skills/
Claude Code	~/.claude/skills/
Copilot	~/.copilot/skills/

cp -r skills/* ~/.config/opencode/skills/

Install agents from The Agency (Optional, but recommeded):

Follow the instructions from their repository

Or use the installer (convenience)

One-time setup. The agent loads only what each task needs.

Via curl:

curl -sL https://raw.githubusercontent.com/wcgomes/agents-workspace/main/tools/install.sh | bash

Or clone and run locally:

git clone https://github.com/wcgomes/agents-workspace.git
cd agents-workspace
./tools/install.sh

Installer options

Flag	Description
--all	All detected tools (default)
--opencode	OpenCode only
--claude	Claude Code only
--copilot	Copilot only
--no-agency	Skip agency-agents
--division <list>	Install only specific divisions (comma-separated)
--list	Show available skills
--help	Show help

Using --division

Filter which agency-agents divisions to install using --division with a comma-separated list:

# Via curl — install only engineering and security
curl -sL https://raw.githubusercontent.com/wcgomes/agents-workspace/main/tools/install.sh | bash -s -- --division engineering,security

# Local — install specific divisions
./tools/install.sh --division engineering,security

# Combine with --opencode
./tools/install.sh --opencode --division design,marketing

# Combine with --all
./tools/install.sh --all --division testing,support

Available divisions

academic, design, engineering, finance, game-development, gis, marketing, paid-media, product, project-management, sales, security, spatial-computing, specialized, support, testing

See 🎭 The Agency for details on each division.

Supported tools

These are the installer target paths currently supported. They are not the normative discovery contract; runtime discovery should remain source-based and platform-aware.

Tool	Skills path	Agents path
Antigravity	~/.gemini/antigravity/skills/	~/.gemini/antigravity/skills/
Claude Code	~/.claude/skills/	~/.claude/agents/
Copilot	~/.copilot/skills/	~/.copilot/agents/
OpenCode	~/.config/opencode/skills/	~/.config/opencode/agents/

Workflow details

1. The One Rule — the main agent never does the work. It delegates every unit to a subagent. Before any tool call, a self-check confirms the action is allowed: read wiki, talk to user, or dispatch subagent. Everything else is delegated — no size threshold.
2. Team-driven workflow — main agent reads wiki/index.md for context, loads orchestrate, then composes the team: analyze domains, discover specialists, size the team, select coordination pattern, plan execution order. Generalist execution is fallback only.
3. Spec-driven workflow (when needed) — for work needing a durable behavior contract (new features, API/contract changes, migrations), load spec-builder before orchestration. Specs live in specs/ (source spec per domain + changes/<id>/ deltas); orchestrate consumes them via an optional Spec ref handoff field and checks conformity during review.
4. Structured delegation — each handoff uses a canonical shape: task, objective, scope, done criteria, constraints, deliverable, return format. Specialists execute the handed scope directly.
5. Parallel specialist teams — independent scopes dispatched to multiple specialists simultaneously.
6. Automatic wiki maintenance — main agent reads wiki/index.md before broad exploration, then evaluates adds, updates, removals, and linting after every task. Self-learning loop — no need to ask.
7. Auto skill evaluation — during wiki ingest, the agent evaluates whether content is better suited as a recurring procedural skill rather than declarative wiki knowledge. When clearly procedural and recurring, it flags the user to decide (create a skill with skill-builder or keep in wiki) — never auto-creates. High-confidence only; declarative knowledge stays in the wiki.
8. Anti-rationalization tables — every skill anticipates excuses agents use to skip steps and refutes them.
9. Role preservation — roles from team composition are mandatory. Adjacent match or generic agent fills gaps. Roles are never dropped or collapsed into one handoff unless there's an explicit quality reason and verification is not reduced.

Mechanism	Skill	What it does
Orchestration	orchestrate	Full coordination cycle: analyze domains, discover specialists, compose team, plan execution, handoff, review and synthesize.
Self-learning wiki	wiki	Reads wiki/index.md before broad exploration, then evaluates adds, updates, removals, and linting after tasks.
Skill authoring	skill-builder	Creates, refines, and validates Agent Skills following the agentskills.io spec.
Spec-driven workflow	spec-builder	Creates, evolves, and archives durable behavior contracts (specs/) before implementation. orchestrate consumes via Spec ref.

Skills load on-demand: wiki for context first, then orchestrate for planning or executing delegated work. When work needs a durable behavior contract, spec-builder loads before orchestrate.

Structure

AGENTS.md              # Boot policy — copy to each workspace
skills/                # Loadable behavioral rules — install globally
  orchestrate/         # Full coordination cycle: assemble, delegate, review, synthesize
  wiki/                # Wiki query and self-learning loop
  skill-builder/       # Skill authoring and validation
  spec-builder/        # Spec-driven workflow: durable behavior contracts

# In your workspace (created by the agent)
wiki/                  # Workspace knowledge — created on setup/first ingest, then maintained automatically
  index.md
  architecture.md      # System structure overview
  conventions/         # One file per convention
  domain/              # One file per business rule
  decisions/           # One file per ADR
specs/                 # Durable behavior contracts — created by the agent when spec-builder is used (source specs + changes/)
.agents/skills/        # Workspace-local skills (explicit creation)
  <your-custom-skill>/