secure-agent-playbook

Play: Securable Code Analysis (FIASSE v1.0.4 / SSEM)

Step-by-step runbook for executing an SSEM-scored review.

Source of truth: plugins/code-security-skills/skills/securability-engineering-review/SKILL.md defines the rubric, equal-weight scoring (1/3 per pillar; 1/4 within Maintainability; 1/3 within Trustworthiness and Reliability), severity classification, output format, and 50-item checklist. This play does not redefine them — it sequences the work.

Trigger Conditions

Run this play when:

Inputs

Steps

1. Establish scope and context

Capture before scoring:

Without this, scores are guesses.

2. Apply triage and sampling (large codebases only)

For codebases beyond a few thousand LoC, follow the triage strategy in the skill: trust boundaries first, then security-sensitive modules, data-access layer, architectural seams, cross-cutting infrastructure, and a small spot-sample of business logic.

Mark every sampled path in the report. For un-sampled areas, cap scores at 6 and call out the gap in the assessment line. Do not extrapolate.

3. Inspect the code, not the docs

Open files. Trace flows. Sample tests. Rubric anchors are about what is there, not what is claimed.

4. Score Maintainability (4 attributes)

Score each on the skill’s 0-10 anchor scale, citing file paths or patterns:

5. Score Trustworthiness (3 attributes)

6. Score Reliability (3 attributes)

7. Apply pattern tagging

For each weakness, name the principle violated using the Pattern Tag Reference in the skill. “Derived Integrity violation (FIASSE v1.0.4 S4.4.1.2)” is actionable; “the auth is sketchy” is not.

8. Apply the Four-Question Framework at the code level (FIASSE v1.0.4 S4.2.1)

Use static-analysis findings as starting points, then think deeper:

  1. What are we building?
  2. What can go wrong?
  3. What are we going to do about it?
  4. Did we do a good job?

Map solutions back to SSEM attributes — prefer architectural fixes over line-level patches when the same root cause produces multiple findings.

9. Assess dependency stewardship

Per FIASSE v1.0.4 S4.5 (Management) and S4.6 (Stewardship), evaluate:

10. Compute scores

Show the math in the report.

11. Classify each finding’s severity

Use the severity table in the skill — engineering-impact based, not CVSS. Severities are CRITICAL / HIGH / MEDIUM / LOW / INFO.

12. Assemble the three-part report

Use the output format and checklist defined in the skill:

Use templates/report.md as the assembly scaffold.

Quality Gates

References