AI-Agents-Orchestrator: Skill for Claude Code

Context Graph Builder Skill

Build, maintain, and enrich the project's context graph as you work. This skill runs automatically — agents should follow these guidelines during every task execution to incrementally improve the context graph.

When to Build Context

Always update the graph when you:

• Complete a task (success or failure)
• Discover a code pattern or anti-pattern
• Make an architectural decision
• Encounter and fix an error
• Learn a user preference (coding style, framework choice, etc.)
• Modify files in the project

Build from scratch when:

• The user provides a --project path for the first time
• The user requests rescan or rebuild context
• The graph is empty for the active project

How to Build Context

1. Project Registration (First Use)

When a project path is provided, the system auto-scans to create:

• A PROJECT node (root anchor for the project graph)
• FILE nodes for each directory
• PATTERN nodes for detected languages, frameworks, and structure
• DECISION nodes for detected CI/CD, testing, and infrastructure choices
• CONTAINS / RELATED_TO edges linking them all

2. Incremental Updates During Operation

After each task execution, store context:

# After completing a task
manager.store_task(
    task_description="What was done",
    outcome="The result",
    success=True,
    agents_involved=["claude", "codex"],
    files_modified=["src/auth.py"],
    project_id=project_id,  # Scope to current project
)

# When you discover a useful pattern
manager.store_pattern(
    pattern_name="Error Handling Convention",
    pattern_type="convention",
    description="This project uses Result types instead of exceptions",
    examples=["def fetch_user(...) -> Result[User, Error]: ..."],
    languages=["python"],
)

# When you encounter and fix a bug
manager.log_mistake(
    error_type="import_error",
    error_message="Circular import between auth and users modules",
    context_description="When refactoring the auth module",
    correction="Moved shared types to a common.types module",
    prevention_strategy="Keep shared types in dedicated modules",
    severity="medium",
)

# When an architectural decision is made
manager.store_decision(
    decision_title="Use PostgreSQL over MongoDB",
    decision_description="Chose relational DB for strong consistency",
    rationale="ACID transactions needed for payment processing",
    alternatives_considered=["MongoDB", "CockroachDB"],
)