breadboard-reflection

Audit breadboard wiring against requirements to surface design smells and naming inconsistencies.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cmbays/print-4ink --skill breadboard-reflection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: breadboard-reflection
Source: https://github.com/cmbays/print-4ink/tree/main/.claude/skills/breadboard-reflection
Command: npx skills add https://github.com/cmbays/print-4ink --skill breadboard-reflection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Find design smells in breadboards and fix them. Traces user stories through wiring, applies the naming test, and verifies consistency. Works on any breadboard built with the /breadboarding skill.

Core Features & Use Cases

  • Trace user stories through the wiring to ensure the wiring tells a coherent story that achieves the expected effect.
  • Apply the naming test to ensure affordances have a single idiomatic verb and clear boundaries.
  • Verify wiring consistency by cross-checking the breadboard diagram with requirements and, if available, the codebase for implementation alignment.
  • Phase awareness supports Phase 1 smell detection from wiring and Phase 2 smells requiring code comparison.

Quick Start

Audit the breadboard by supplying the breadboard document and requirements to generate an audit of smells and recommended fixes.

Frequently Asked Questions about breadboard-reflection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit breadboard wiring for design smells and naming inconsistencies?

Audit breadboard wiring for design smells by supplying the breadboard document and requirements to trace user stories, apply the naming test, and verify wiring consistency against expected outcomes.

What is the naming test when validating breadboard affordances?

The naming test validates breadboard affordances by ensuring each has a single idiomatic verb and clear boundaries. This surfaces naming inconsistencies that obscure the design intent during a QA gate.

How do I trace user stories through breadboard wiring to check traceability?

Trace user stories through breadboard wiring by mapping the wiring connections to ensure they tell a coherent story that achieves the expected effect, validating traceability against documented requirements.

Can I verify breadboard wiring consistency against the codebase for implementation alignment?

Verify breadboard wiring consistency against the codebase by providing codebase access alongside the breadboard document. This checks implementation alignment and detects Phase 2 smells requiring code comparison.

Do I need a specific file path format to audit an existing breadboard?

You need the breadboard document located at docs/workspace/{pipeline-id}/breadboard.md or docs/breadboards/{topic}-breadboard.md for Phase 1 legacy work. Codebase access is optional and only needed for code verification.

What are the limitations of auditing breadboards without codebase access?

Auditing breadboards without codebase access limits detection to Phase 1 smells derived from wiring and requirements only. Phase 2 smells requiring code comparison for implementation alignment cannot be surfaced without codebase access.