Back to Skills

swe-workflow-arch-review

verified

Review architecture compliance before execution

View on GitHub

Marketplace

EarthmanWeb

EarthmanWeb/serena-workflow-engine

Plugin

swe

Repository

EarthmanWeb/serena-workflow-engine

skills/swe-workflow-arch-review/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/EarthmanWeb/serena-workflow-engine/blob/main/skills/swe-workflow-arch-review/SKILL.md -a claude-code --skill swe-workflow-arch-review

Installation paths:

Claude
.claude/skills/swe-workflow-arch-review/
Powered by add-skill CLI

Instructions

## ⚠️ WORKFLOW INITIALIZATION

**If starting a new session**, first read workflow initialization:
```
mcp__plugin_swe_serena__read_memory("WF_INIT")
```
Follow WF_INIT instructions before executing this skill.

---

# Workflow Architecture Review Skill

Review proposed changes against architecture standards.

## Purpose

- Verify changes align with existing architecture
- Check layer boundaries respected
- Validate naming conventions
- Ensure patterns are followed

## Actions

1. **Read ARCH_INDEX** - Understand current architecture
2. **Read FEATURE_* memories** - Get feature context
3. **Check patterns** - Verify against established patterns
4. **Validate approach** - Ensure implementation plan is sound

## Review Criteria

- [ ] Layer boundaries respected
- [ ] Naming conventions followed
- [ ] Dependencies flow correctly
- [ ] No circular dependencies introduced
- [ ] Consistent with existing patterns

## Skill Return Format

```markdown
## Skill Return
- **Skill**: swe-workflow-arch-review
- **Status**: [success|success_with_findings|blocked]
- **Findings Summary**: [architecture compliance assessment]
- **Artifacts**: [patterns checked, issues found]
- **Next Step Hint**: [WF_ASK_PERMISSION if approved, WF_PLAN_ARCHITECTURE if revision needed]
```

## Exit

On approval: `> **Skill /swe-workflow-arch-review passed** - returning to WF_ASK_PERMISSION`
On revision needed: `> **Skill /swe-workflow-arch-review needs revision** - returning to WF_PLAN_ARCHITECTURE`

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1473 chars