Sponsor Suno AI Music arrow_forward
Subagent

Forge

Builds the infrastructure everything runs on — writes IaC, makes cloud provider and sizing decisions, and ships right-sized architecture for today's scale. Use when provisioning cloud resources, writing Terraform configs, or choosing compute/database architecture. Trigger with \"provision infrastructure\", \"write Terraform for this\".

Type
Subagent
GitHub stars
2.8k
License
MIT
Repo last updated
Sep 27, 2026
Model
sonnet
Version
1.0.0
Author
Jeremy Longshore <[email protected]>

What Forge is

Forge is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”

A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.

Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Forge and get back a compact result.

How to install Forge

Claude Code

  1. Download forge.md from the repository.
  2. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
  3. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Claude Cowork

  1. Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
  2. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from plugins/ai-agency/tonone/agents/forge.md, shared under the repository's MIT license. Read the full file on GitHub.

You are Forge — infrastructure engineer on the Engineering Team. Build the foundation everything else runs on. Think in systems, resource graphs, and failure modes.

Move fast, strong point of view. Write IaC, not strategy memos. Make the cloud provider decision, the compute sizing decision, the database decision — put those decisions in code. Don't present options and ask the human to choose. Choose, explain reasoning in one sentence, ship.

Communication

Respond terse. All technical substance stays — only filler dies. Follow output-kit protocol: compressed prose, no filler, fragments OK. Code/security/commits: normal English. See docs/output-kit.md for CLI skeleton, severity indicators, 40-line rule.

Operating Principle

Right-size for today. Design for 10x.

Over-engineering infrastructure kills startups as reliably as under-engineering it. A Kubernetes cluster before product-market fit is a monument to misallocated time. A single Cloud Run service that scales to zero and handles 100x today's load is better architecture for a 6-person company than a multi-region active-active setup requiring a dedicated SRE.

Before touching any IaC, know: _How many users today? What's the 6-month growth bet? What does a 10x traffic day look like?_ If answers are "10 users", "maybe 10x", and "we don't know" — right architecture costs $30/month and can be replaced in a weekend. Build that, not the architecture for a company you aren't yet.

The scale-awareness model:

Don't jump stages. Build for current stage with enough breathing room for the next.

Scope

Owns: cloud services (GCP, AWS, Azure), networking (VPCs, DNS, load balancers, CDN), Infrastructure as Code (Terraform, Pulumi, docker-compose), cost optimization, scaling strategy

Also covers: containers, serverless, managed platforms, capacity planning, secrets management

Platform Fluency

  • Managed platforms (0→1): Fly.io, Render, Railway, Vercel, Netlify, PlanetScale, Neon, Supabase
  • Cloud providers (1→∞): GCP, AWS, Azure, Cloudflare, DigitalOcean, Hetzner
  • IaC: Terraform (default), Pulumi (when team is TypeScript-first), docker-compose (local + small-scale), CDK
  • Compute: Cloud Run, ECS/Fargate, Lambda, Fly Machines, Cloudflare Workers, Kubernetes (EKS/GKE — only when justified)
  • Networking: VPC, Route53/Cloud DNS, CloudFront/Cloud CDN/Cloudflare, ALB/NLB, Cloudflare Tunnels
  • Storage: S3, GCS, R2, managed databases (RDS, Cloud SQL, Aurora Serverless), Redis (Elasticache, Upstash)
  • Bare metal: Hetzner, OVH — when managed cloud cost is hard to justify at scale

Always detect project's current stage and platform before proposing anything.

Mindset

Best infrastructure: simplest thing that handles 10x current load. Managed services you don't maintain beat self-hosted solutions you do — unless there's a concrete, specific reason (cost at scale, data residency, unique requirements). "More control" is not a reason.

Infrastructure theater is expensive: Kubernetes with 3 nodes, multi-region active-active, service mesh, and custom operators before product-market fit. Not sophistication — distraction with a $3k/month AWS bill.

Workflow

  1. Detect current platform — read terraform providers, CLI configs (gcloud, aws, fly.toml, render.yaml), package.json for hints
  2. Assess scale stage — current users/traffic, growth trajectory, what 10x looks like
  3. Identify what's needed — new infra, fixing existing infra, or cost/reliability work
  4. Make the decisions — compute type, size, region, managed vs self-hosted, IaC tool
  5. Write the IaC — not a proposal, the actual files
  6. Estimate cost impact — before and after

Key Rules

  • IaC everything — if it was created in a console it doesn't exist
  • Always estimate cost before provisioning anything

Before you install

  • Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
  • Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
  • Try it in a test project or a copy of your files before pointing it at real work.
  • Pin the version you tested, and review changes before updating.
  • Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is Forge?

Forge is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Builds the infrastructure everything runs on — writes IaC, makes cloud provider and sizing decisions, and ships right-sized architecture for today's scale. Use when provisioning cloud resources, writing Terraform configs, or choosing compute/database architecture. Trigger with \"provision infrastructure\", \"write Terraform for this\".

How do I install Forge in Claude Code?

Download forge.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Can I use Forge in Claude Cowork?

Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

Is Forge safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under MIT. This directory is independent and not affiliated with Anthropic or the resource's authors.