Skip to content

feat: security-review agent — reusable skill + CLI assessment - #131

Merged
matheusmlopess merged 2 commits into
devfrom
feature/security-review-agent
May 1, 2026
Merged

feat: security-review agent — reusable skill + CLI assessment#131
matheusmlopess merged 2 commits into
devfrom
feature/security-review-agent

Conversation

@matheusmlopess

Copy link
Copy Markdown
Owner

Summary

  • Deploys security-review agent following the 5-directory AgentFactory standard
  • Adds skills/security-review/ with SKILL.md, skill-manifest.json, and two references/ files
  • Packages the agent as security-review-v1.0.0.zip and transfers it to agentfactory-harness via the CLI
  • Adds docs/CLI-ASSESSMENT.md written from 9 live observations during the transfer lifecycle

What the skill does

Generates or updates a dated docs/REVIEW-SECURITY-ARCHITECTURE-YYYY-MM-DD.md on any TypeScript/Python/Go repo, covering:

  • Component status matrix (all source files)
  • 7 Mermaid diagrams (architecture, primary flow, pipeline, routing, state machine, dispatch, roadmap)
  • SEV-1/SEV-2 security findings with code snippets and remediations
  • Design gaps (D-N) with file:line references
  • Prioritised recommendations table (P0–P3)

Supports two modes: new (fresh dated report) and update (delta on same branch, version bumped, fixed items struck through).

CLI Assessment highlights (from live execution)

5 gaps surfaced during the transfer:

  1. --version not defined on root group
  2. triggers not propagated from SKILL.md to skill-manifest.json
  3. --project-root resolves against CWD before applying the flag
  4. audit requires manual sync first (unlike wrap)
  5. No status, upgrade, or --dry-run commands

Full details in docs/CLI-ASSESSMENT.md.

Test plan

  • agentfactory-gen audit security-review exits 0
  • agentfactory-gen wrap security-review produces ZIP with 6 files
  • agentfactory-gen brief shows security-review in skill table
  • agentfactory-harness has .ai/skills/security-review/ and .ai/agents/security-review/
  • /security-review invocation in Claude session loads the skill

🤖 Generated with Claude Code

matheusmlopess and others added 2 commits April 28, 2026 10:25
Adds a fully packaged security-review agent following the AgentFactory
5-directory standard. The agent's skill generates or updates dated
REVIEW-SECURITY-ARCHITECTURE-YYYY-MM-DD.md reports covering: component
status matrix, 7 Mermaid diagrams, SEV-classified security findings,
design gaps, and a prioritised recommendations table.

CLI-ASSESSMENT.md documents observations from the live deploy→wrap→import
lifecycle used to transfer this agent to agentfactory-harness, including
9 gaps found during actual execution (triggers split, --version missing,
--project-root CWD resolution, audit pre-sync requirement, etc.).

Co-Authored-By: 🤖Factory <noreply@agentfactory.dev>
Co-Authored-By: 🤖Factory <noreply@agentfactory.dev>
@matheusmlopess
matheusmlopess merged commit cefe40c into dev May 1, 2026
5 checks passed
@matheusmlopess
matheusmlopess deleted the feature/security-review-agent branch May 1, 2026 15:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant