Back to Skills

swe-scaffold-project

verified

Initialize workflow for new empty projects. Creates core memories and directory structure.

View on GitHub

Marketplace

EarthmanWeb

EarthmanWeb/serena-workflow-engine

Plugin

swe

Repository

EarthmanWeb/serena-workflow-engine

skills/swe-scaffold-project/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-scaffold-project/SKILL.md -a claude-code --skill swe-scaffold-project

Installation paths:

Claude
.claude/skills/swe-scaffold-project/
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.

---

# Scaffold Project Skill

Initialize workflow system for new or empty projects.

## When to Use

- New projects without existing memories
- Projects missing INDEX_FEATURES
- Converting existing projects to workflow system

## Detection Triggers

Automatically suggested when:
- No `.serena/memories/` directory exists
- No `INDEX_FEATURES.md` file exists
- `INDEX_FEATURES.md` has zero features registered

## Process

### Stage 1: Project Detection

```bash
# Detect project root
git rev-parse --show-toplevel || pwd

# Detect package manager
[ -f "package.json" ] && echo "npm"
[ -f "composer.json" ] && echo "composer"
[ -f "Cargo.toml" ] && echo "cargo"
[ -f "requirements.txt" ] && echo "pip"
[ -f "go.mod" ] && echo "go"

# Detect primary language
find . -name "*.ts" -o -name "*.js" | head -1  # TypeScript/JavaScript
find . -name "*.py" | head -1                   # Python
find . -name "*.php" | head -1                  # PHP
find . -name "*.rs" | head -1                   # Rust
find . -name "*.go" | head -1                   # Go
```

### Stage 2: Directory Setup

```bash
mkdir -p .serena/memories
mkdir -p .claude/skills
mkdir -p .claude/hooks
```

### Stage 3: Core Memory Creation

Create from templates:

1. **_INDEX** - Navigation hub
```markdown
# _INDEX - Memory Navigation

## Quick Reference
- Features: INDEX_FEATURES
- Architecture: ARCH_INDEX
- Workflows: INDEX_WORKFLOWS_STATES

## Memory Types
| Prefix | Purpose |
|--------|---------|
| FEATURE_ | Feature configs |
| DOM_ | Domain behaviors |
| SYS_ | System references |
| REF_ | Reference docs |
| INDEX_ | Navigation |
| WF_ | Workflow states |
| WORKING_MEMORY_ | Session state |
```

2. **INDEX_FEATURES** - Empty feature registry
```markdown
# INDEX_FEATURES

## Registered Features
(none yet - ru

Validation Details

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