Skip to content

agents-workspace β€” a workflow layer that orchestrates The Agency agents intelligently.Β #494

@wcgomes

Description

@wcgomes

Thank you, agency-agents community! πŸ™Œ

I created agents-workspace β€” a specialist-first, subagent-driven workflow layer that enforces intelligent task delegation across your 144+ agents.

The workflow difference

Instead of hoping the right agent picks up the right context (or specifying it yourself):

Before After
Raw prompt β†’ single agent Task analyzed β†’ specialist selected via delegate
Context window bloated after 3 turns Each subagent gets focused, isolated context
All tasks sequential Independent tasks run in parallel
Repeat the same mistakes Memory persists via wiki
No validation before coding implement skill validates understanding + enforces minimal changes
Changes spread across files Minimal, targeted diffs per task
Same pattern, same fix every time agents-skills evolves local skills from 3x repeated patterns

How it works

  1. Task arrives β†’ Load delegate to assess: define done criteria, consult wiki for existing workspace context
  2. Specialist discovery β†’ delegate scans available agents, selects the best semantic match per task scope/constraints
  3. Execution β†’ Delegate to specialists, parallelize non-overlapping tasks, enforce implement skill for all code changes
  4. Error handling β†’ debug skill automatically triggers for unexpected behavior/errors
  5. After completion β†’ wiki ingests learnings, lints for stale references or contradictions
  6. Pattern detected 3x? β†’ agents-skills proposes or creates a local skill to automate the workflow
  7. Closure β†’ Review all delegated output against AGENTS.md rules before marking complete

What you get

5 core orchestration skills plus your full agent pool, enforced by mandatory AGENTS.md rules:

  • delegate β€” Mandatory specialist discovery, selection, and delegation workflow
  • wiki β€” Persistent workspace memory for pre/post task context
  • implement β€” Pre-change validation, minimal diffs, and code correctness enforcement
  • debug β€” Error investigation and unexpected behavior resolution
  • agents-skills β€” Local skill creation, refinement, and validation from repeated patterns
  • Core rules: brevity, specialist-first fallback, subdelegation governance, invocation contracts

Quick start

curl -sL https://raw.githubusercontent.com/wcgomes/agents-workspace/main/tools/install.sh | bash
cp AGENTS.md /your-project/

Tell your agent: "Set up the wiki and start working"

Devcontainer fans πŸŽ‰

For those who prefer devcontainers, I also created dedicated features:

Add them to your devcontainer.json and get everything pre-configured in your container.


Install once, use it across every project. πŸš€

Feedback and PRs welcome!

GitHub

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions