SuperAPI AI Directory

soc-pipeline

Coding & development

View repository

Updated 10-16 09:29

About this skill

SoC Pipeline

Coordinate work; do not implement RTL or testbench content in the coordinator.

Preflight

  1. Read ../../rules/01_swarm_flow.md, ../../rules/02_toolchain.md, ../../rules/05_pipeline_state.md, and ../../rules/13_review_gate.md when review or commit readiness is in scope. Read coding style or exceptions only when relevant. For any architecture, documentation, RTL, verification, synthesis, physical-design, or material refactoring task, also read ../../rules/06_design_knowledge.md and query soc-ai-kb before design decisions.
  2. Resolve the absolute module workspace and module name.
  3. Query pipeline_state.json; initialize it only when absent. Never overwrite existing state implicitly.
  4. For chip-level, subsystem-level, or multi-module requirements without an approved architecture handoff, dispatch soc-architect first for IP selection, technology/process selection, and the overall SoC integration architecture plan. Treat it as pre-doc planning, not a pipeline_state.json stage.
  5. Select the RTL role:
    • normal logic: soc-rtl-designer
    • top integration: soc-integrator
    • CRG: soc-crg-engineer, only when crg-gen is registered
    • OpenROAD physical-design handoff: soc-pd-engineer
  6. Select soc-reviewer for post-stage, pre-commit, or validation-evidence audit. The reviewer reports findings only and never closes a pipeline stage. Use .agents/scripts/check_loop_state.py <workspace> --mode normal after stage work and --mode strict before commit readiness when a workspace is available.
  7. Reviewer dispatch includes relevant review domains, reports and delivery inputs, knowledge-base scope, and the structured output contract from 13_review_gate.md. Missing knowledge-base rules require Need Human Confirmation; they are never synthesized from memory.

Delegation

Use named role agents when supported. Otherwise spawn a generic subagent with the matching file under ../../agents/ as its role contract. Respect host delegation policy and do not silently replace a required role agent with coordinator-authored RTL.

For large stage tasks, the coordinator may split work across multiple agents automatically when the host allows it. Keep one role agent as the stage owner. Sidecar agents must have explicit, disjoint write ownership and may not independently close the stage. The stage owner integrates sidecar work, runs the required registered MCP checks, validates artifacts, and updates pipeline_state.json.

Every dispatch prompt includes:

  • absolute workspace
  • task_name
  • objective and approved assumptions
  • single- or multi-module state mode
  • for pipeline-stage agents only, requirement to update state and quote the update_state.py stdout line

After each pipeline-stage role returns, query state immediately and verify status, artifacts, and all checks. After soc-architect returns, verify that architecture artifacts exist and are ready for the doc stage. When review is requested or commit readiness matters, dispatch soc-reviewer after the stage owner reports and before claiming the loop is closed. Do not dispatch downstream work after failure.

Execution contract

  • Canonical artifact paths: docs/, de/rtl/, de/run/, de/syn/, dv/tb/, dv/sim/.
  • Architecture handoff artifacts stay under docs/ and must cover IP selection, technology/process selection, and the integration architecture before the doc stage consumes them.
  • EDA execution uses registered MCP tools. Verification calls soc-build.soc_sim; synthesis calls soc-build.soc_syn; physical-design handoff calls soc-openroad.soc_openroad_*. No direct EDA shell fallback.
  • doc -> rtl; verification and synthesis may run independently after RTL passes.
  • Treat estimated timing and synthetic PASS markers as failures of validation integrity.
  • For an approved doc-stage exception, record doc skipped with a concrete note before starting RTL.

Stop and report a precise blocker if required MCP capability, an approved interface decision, or an EDA dependency is unavailable.