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

•Phase 4 registry tooling is available (scripts/devops/registry/abilities.py)
•id does not already exist in ability registries
•Specified entrypoints have valid ABILITY.md files with marker blocks
•For workflows: workflow_file exists or steps are valid
•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

code

/.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:

•Delete the registry entry:

bash

rm /.system/registry/high-level/<id>.yaml

•Regenerate ABILITY.md indexes: