Agent skill

workbench-architecture

Architecture and ADR workflows for Workbench CLI. Use when documenting system design, decisions, tradeoffs, or rationale that must be tracked over time.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/incursa/workbench/tree/main/.codex/skills/workbench-architecture

SKILL.md

Key settings

  • .workbench/config.json: paths.docsRoot, git.defaultBaseBranch.
  • Use workbench.ps1 config show --format json to confirm defaults.

Core workflows

  1. Planning phase: create architecture docs for design intent and scope.
  2. When a decision is made or changes, create or update an ADR.
  3. Link ADRs and architecture docs to work items and specs.

Commands

Create an architecture doc:

bash
workbench.ps1 doc new --type doc --title "Subsystem overview" --path architecture/subsystem-overview.md --work-item WI-WB-0001

Create an ADR:

bash
workbench.ps1 doc new --type adr --title "Decision title" --path decisions/ADR-YYYY-MM-DD-title.md --work-item WI-WB-0001

Link existing docs to a work item:

bash
workbench.ps1 item link WI-WB-0001 --spec /overview/spec.md --adr /decisions/ADR-YYYY-MM-DD-title.md

Sync backlinks:

bash
workbench.ps1 doc sync --all

Output

  • Architecture docs and ADRs with consistent front matter.
  • Work items that reference related specs and ADRs.

Guardrails

  • Use ADRs for decisions, architecture docs for structure and flows.
  • Keep ADR status updated (proposed, accepted, superseded, deprecated).
  • If an ADR does not exist for a significant decision, create one.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

incursa/workbench

workbench-github

GitHub workflows for Workbench CLI. Use when creating pull requests from work items or wiring GitHub-specific actions.

0 0
Explore
incursa/workbench

dotnet-build-diagnostics

Capture dotnet environment and CI-style build diagnostics with binlog and summary output.

0 0
Explore
incursa/workbench

dotnet-test-triage

Run dotnet test, capture failed test cases, and generate a rerun filter plus a markdown failure summary. Use when test runs fail and you need a focused rerun command or a compact failure report.

0 0
Explore
incursa/workbench

dotnet-symbol-grep-recipes

Quick ripgrep recipes for common C# navigation tasks in this repo.

0 0
Explore
incursa/workbench

workbench-docs

Documentation workflows for Workbench CLI. Use when creating or updating specs, ADRs, runbooks, guides, or general docs, and when syncing backlinks or change notes.

0 0
Explore
incursa/workbench

workbench-work-items

Work item management for Workbench CLI. Use when creating, updating, linking, or closing work items and tracking execution status.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results