Parallel Agent Contracts

by parcadeid07ff4b06b62No license3.9K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 8 months ago

Parallel Agent Type Contracts

Instructions onlyAI & Agents Software Development

AI-generated overview

Provides prompt templates and a canonical type map so parallel coding agents avoid duplicating TypeScript types.

What it does: This skill supplies guidance for writing prompts when several agents implement code in parallel. It defines required prompt sections: a verification command using the TypeScript compiler, a grep-before-create check for existing types, and a canonical type map listing which file owns each shared type and how to import it. It also includes a reusable prompt template and a short explanation of why the approach works.
When to use it: Use it when coordinating multiple agents on the same TypeScript codebase and wanting to prevent conflicting or duplicated type definitions. It fits prompt authoring for parallel implementation work rather than a single-agent coding task.
Requirements: No scripts are shipped; it is instructions only. The described workflow assumes a TypeScript project, the npx tsc command, and grep available in the environment.

Parallel Agent Type Contracts

When launching parallel agents for code implementation, prevent type duplication.

Required in Every Agent Prompt

1. Verification Command (MANDATORY)

markdown

## Before Marking CompleteRun verification:\`\`\`bashnpx tsc --noEmit 2>&1 | head -20\`\`\`If ANY type errors exist, fix them before completing.

## Before Marking CompleteRun verification:\`\`\`bashnpx tsc --noEmit 2>&1 | head -20\`\`\`If ANY type errors exist, fix them before completing.

2. Grep-Before-Create

markdown

## Before Creating Any Type/InterfaceFirst check if it exists:\`\`\`bashgrep -r "interface YourTypeName\|type YourTypeName" src/\`\`\`If found, import it. NEVER duplicate existing types.

## Before Creating Any Type/InterfaceFirst check if it exists:\`\`\`bashgrep -r "interface YourTypeName\|type YourTypeName" src/\`\`\`If found, import it. NEVER duplicate existing types.

3. Canonical Type Map

Include relevant entries from this map in agent prompts:

Type	Owner File	Import From
`NormalizedTool`	`src/sdk/agent.ts`	`'./agent'`
`ToolCall`	`src/sdk/agent.ts`	`'./agent'`
`ToolResult`	`src/sdk/agent.ts`	`'./agent'`
`ToolDefinition`	`src/sdk/agent.ts`	`'./agent'`
`Message`	`src/sdk/types.ts`	`'./types'`
`ContentBlock`	`src/sdk/types.ts`	`'./types'`
`TokenUsage`	`src/sdk/types.ts`	`'./types'`
`ProviderAdapter`	`src/sdk/providers/index.ts`	`'./providers'`
`RiggClient`	`src/sdk/client.ts`	`'./client'`

Prompt Template

When spawning implementation agents:

markdown

# Task: [Description]
## Type Ownership (DO NOT recreate)- [List relevant types from canonical map]
## Before Creating New TypesRun: `grep -r "interface TypeName" src/` - if exists, import it.
## Before Marking CompleteRun: `npx tsc --noEmit 2>&1 | head -20`Fix all type errors before completing.
## Your Implementation[Actual task description]

# Task: [Description]
## Type Ownership (DO NOT recreate)- [List relevant types from canonical map]
## Before Creating New TypesRun: `grep -r "interface TypeName" src/` - if exists, import it.
## Before Marking CompleteRun: `npx tsc --noEmit 2>&1 | head -20`Fix all type errors before completing.
## Your Implementation[Actual task description]

Why This Works

Type checker is the contract - tsc catches conflicts automatically
Grep is fast - 1 second to check if type exists
Explicit ownership - No ambiguity about where types live
Fail fast - Agent can't claim "done" with broken types

Source and attribution

Source:parcadei/continuous-claude-v3in.claude/skills/parallel-agent-contractsat commitd07ff4b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Parallel Agent Contracts

Parallel Agent Type Contracts

Required in Every Agent Prompt

1. Verification Command (MANDATORY)

2. Grep-Before-Create

3. Canonical Type Map

Prompt Template

Why This Works

Source and attribution

More from parcadei/continuous-claude-v3

Tldr Stats

Wiring

Workflow Router

Validate Agent

Tour

Tldr Overview

More in AI & Agents

Ppt Template Creator

Skill Development

Plugin Structure

Command Development

Claude Md Improver

Find Skills