Project Onboarding

Tool: project-onboard Model: Efficient

Trigger & Intent

Triggered by: A new developer joining a project, or a comprehensive knowledge-capture session for an existing codebase.

Intent: Converts a raw codebase into structured, navigable memory. Terminal workflow node — does not chain to further workflows.

Resource Pooling

Capability profile: onboarding — requires codebase_scan + memory_write, prefers cost_sensitive, serial execution.

Required Skills

Skill	Role
`core-codebase-qa`	Codebase question and answer
`core-requirement-tracker`	Requirement extraction and tracking
`doc-readme`	README and project overview generation
External: `context7-mcp`	Live framework documentation retrieval
External: `mcp-github`	Repository metadata and issue context

Input Schema

{
  repoUrl: string;
  knowledgeDepth: "surface" | "full";
}

Decisions & Throw-Backs

Terminal node — no downstream throw-backs. If context7-mcp fails to resolve library docs (network unavailable) → falls back to cached documentation in doc-readme skill.

Success Chains

This is a terminal node. No downstream chains.

FSM — Observer-system entanglement

stateDiagram-v2
    [*] --> UncertainSystemState

    UncertainSystemState --> ContextCapture
    ContextCapture --> MemoryReconstruction

    MemoryReconstruction --> ObserverProjection
    ObserverProjection --> EntangledModel

    EntangledModel --> MeasurementEvent
    MeasurementEvent --> Decoherence
    Decoherence --> ProjectedKnowledge

    ProjectedKnowledge --> KnowledgeSufficient: depth threshold met
    ProjectedKnowledge --> FurtherCapture: insufficient depth

    FurtherCapture --> ContextCapture
    KnowledgeSufficient --> StableMemoryState
    StableMemoryState --> [*]

Execution Sequence

sequenceDiagram
    participant Orchestrator
    participant Pool (Analytical)
    participant Pool (Mechanical)
    participant Tool (Context7)
    participant Tool (GitHub)

    Orchestrator->>Pool (Analytical): Allocate Capability Profile (serial)
    activate Pool (Analytical)

    Pool (Analytical)->>Tool (Context7): Fetch library docs
    Pool (Analytical)->>Tool (GitHub): Fetch repo metadata + issues
    Tool (Context7)-->>Pool (Analytical): Docs snapshot
    Tool (GitHub)-->>Pool (Analytical): Repo context

    Pool (Analytical)->>Pool (Mechanical): Delegate README generation
    Pool (Mechanical)-->>Pool (Analytical): Structured README

    Pool (Analytical)-->>Orchestrator: Knowledge Package
    deactivate Pool (Analytical)

    Note over Orchestrator: Terminal node — no further chains