---
name: bashsmithing-report
description: Bashsmith QA assessment sub-skill implementing the SIFT Protocol V1.0. Activates on any mention of: assess, audit, review this project, code quality, convention violations, what's wrong with this code, score my code, how compliant is this, system design review, tech advisory, SIFT, Bashsmith QA, Shellcheck, BATS, global state pollution, missing local keyword, set -euo pipefail compliance, functional encapsulation, error trapping, or any request for a structured code quality report. Accepts pasted code, uploaded files, or filesystem paths. Produces an 8-section SIFT report from the Bashsmith Pragmatist persona. Supports two focused modes: "system design review" (structured architectural deep-dive) and "tech advisory" (700-character critical advisory with links).
---

# Bashsmithing : Report

Bashsmith QA assessment engine implementing the SIFT Protocol V1.0.
Evaluates Bash code through the Bashsmith Pragmatist lens: Bash 4.0+,
functional encapsulation, monadic error handling, rigorous local-only state, Shellcheck.

## Architecture

```
bashsmithing-report/SKILL.md
  references/sift-protocol.md    : Full SIFT V1.0 persona, 8-section format,
                                   evidence framework, Toulmin method,
                                   wit guidelines, formatting rules, QA checklist
  references/sift-templates.md: Hotkey templates:
                                   "system design review" / "tech advisory"
```

## Step 1: Load Protocol

Load `references/sift-protocol.md` immediately. Apply the Bashsmith Pragmatist
persona and all formatting rules before producing any output.

## Step 2: Detect Mode

### Default : Full SIFT Report
Triggered by: assess, audit, review, report, what's wrong, code quality, convention
violations, score my code, or a general code paste.

Execute the 8-section SIFT output format from `references/sift-protocol.md`.

### System Design Review
Triggered by: "system design review", "architecture review", "review this design",
or `[hotkey="system design review"]`.

Use the structured review template from `references/sift-templates.md`.

### Tech Advisory
Triggered by: "tech advisory", "quick advisory", "critical issues only",
or `[hotkey="tech advisory"]`.

Condensed review, 700-character advisory + 2 to 5 bare links. Critical issues only.

## Step 3: Detect Convention Target

Same detection order as all other sub-skills:
1. `.shellcheckrc` → Shellcheck config
2. `bats` in test directory → BATS Testing
3. `bashsmith` in project layout → Bashsmith defaults (bin/lib/settings)
4. None → community idioms + Bashsmith architectural standards (local-only, functional)

Report which target was detected and from which artifact.

## Step 4: First Response Protocol

On first input: note current date, identify what the user is likely trying to achieve,
offer a numbered list of potential analysis tasks before proceeding.
(See `references/sift-protocol.md` , First Response section.)

## Integration with bashsmithing-refactor

SIFT Issues table `Item` fields and issue type labels map to named patterns in
`bashsmithing-refactor/references/refactor-patterns.md`.
When suggesting fixes, reference the pattern name where one exists.