# new-ability-high

> Scaffold a high-level ability (workflow-backed). Keywords: ability, high-level, workflow, scaffolding.

- Author: willyu1007
- Repository: willyu1007/AI_First_Template
- Version: 20251224182030
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/willyu1007/AI_First_Template
- Web: https://mule.run/skillshub/@@willyu1007/AI_First_Template~new-ability-high:20251224182030

---

---
name: new-ability-high
description: "Scaffold a high-level ability (workflow-backed). Keywords: ability, high-level, workflow, scaffolding."
---
# Scaffold: New High-Level Ability

This document is an entrypoint for high-level ability scaffolding. The step-by-step flow is in
/.system/skills/ssot/repo/scaffolding/new-ability-high/SKILL.md.

---

## 1. Purpose & Scope

**Purpose**: Register a new high-level ability in the ability registry and update relevant ABILITY.md index files.

**Scope**:
- Creates ability registration in `/.system/registry/high-level/`
- Regenerates ABILITY.md indexes for specified entrypoints
- Validates implementation references

**Out of scope**:
- Implementing the actual workflow/agent logic
- Low-level atomic operations
- Modifying flow graphs

---

## 2. Inputs & Preconditions

### Required Inputs

| Parameter | Type | Description |
|-----------|------|-------------|
| `id` | string | Unique ability identifier (e.g., `code-review.architecture-reviewer`) |
| `summary` | string | One-line description of what this ability does |
| `type` | enum | Ability type: `workflow`, `agent` |
| `entrypoints` | array | ABILITY catalog roots where ability appears |

### Conditional Inputs (based on `type`)

| Parameter | Condition | Description |
|-----------|-----------|-------------|
| `workflow_file` | type=workflow | Path to workflow definition file |
| `steps` | type=workflow | Inline step definitions (alternative to workflow_file) |
| `agent_entry` | type=agent | Agent entry point reference |

### Optional Inputs

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `parameters` | object | {} | JSON Schema for input parameters |
| `tags` | array | [] | Classification tags |
| `hooks` | object | {} | Pre/post hook bindings |

### Preconditions

1. Phase 4 registry tooling is available (`scripts/devops/registry/abilities.py`)
2. `id` does not already exist in ability registries
3. Specified `entrypoints` have valid `ABILITY.md` files with marker blocks
4. For workflows: workflow_file exists or steps are valid
5. For agents: agent_entry reference is valid

---

## 3. Step-by-Step Flow (AI + Human)

See /.system/skills/ssot/repo/scaffolding/new-ability-high/SKILL.md.

---

## 4. Tools & Scripts

| Tool | Purpose |
|------|---------|
| `scripts/devops/scaffold/new_ability_high.py` | Orchestrator script |
| `scripts/devops/registry/abilities.py` | Registry validation and index regeneration |
| `scripts/devops/registry/hooks.py` | Hook binding validation |

---

## 5. Outputs & Side Effects

### Files Created/Modified

```
/.system/registry/high-level/<id>.yaml    # New registry entry
<entrypoint>/ABILITY.md                   # Index block regenerated
```

### Registry Entry Structure (Workflow)

```yaml
id: code-review.architecture-reviewer
summary: Review code changes for architecture compliance
type: workflow
entrypoints:
  - /modules/integration
implementation:
  workflow_file: /.system/skills/ssot/repo/workflow-library/code_review/workflow/code_architecture_reviewer.md
parameters:
  type: object
  properties:
    pr_url:
      type: string
      description: Pull request URL to review
  required:
    - pr_url
hooks:
  pre_call:
    - code_review_gate
```

### Registry Entry Structure (Agent)

```yaml
id: planning.execution-planner
summary: Generate execution plans for complex tasks
type: agent
entrypoints:
  - /modules/integration
implementation:
  agent_entry: /.system/skills/ssot/repo/execution-plans/execution-plan-authoring/SKILL.md
```

---

## 6. Safety & Rollback

### Safety Measures

- `--dry-run` always available for preview
- Human approval required before execution
- Schema validation on registry entry
- Consistency checks via `abilities.py --check`
- Hook binding validation

### Rollback Procedure

If registration fails or needs reverting:

1. Delete the registry entry:
   ```bash
   rm /.system/registry/high-level/<id>.yaml
   ```
2. Regenerate ABILITY.md indexes:
   ```bash
   python scripts/devops/registry/abilities.py --scope integration --regenerate
   ```

---

## 7. Related Documents

- `/.system/skills/ssot/repo/architecture-core-mechanisms/ability-workflow/SKILL.md` - Ability development workflow
- `/.system/registry/schemas/ability_high.schema.yaml` - High-level ability schema
- `/.system/registry/schemas/V1_CORE.md` - V1-core required fields
- `/.system/skills/ssot/repo/scaffolding/new-ability-low/SKILL.md` - Low-level ability scaffolding