aiwf-area

Assigns and validates aiwf area tags for planning entities against declared path globs.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwf-area-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiwf-area
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded/aiwf-area
Command: npx skills add https://github.com/23min/aiwf --skill aiwf-area-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In a monorepo with multiple workstreams, planning entities (epics, ADRs, gaps, decisions, contracts) need a consistent grouping tag, and that tag must match where the actual code work landed. Without enforcement, area labels drift from reality and filtered status or roadmap views become unreliable. ## Core Features & Use Cases - Area assignment at creation: Tag entities explicitly with --area, or let aiwf derive the area from a --path-hint matched against declared paths: globs; ambiguous or unmatched hints never guess. - Closed member set with enforcement: Only declared areas.members plus the reserved global sentinel are valid; areas.required: true makes tagging mandatory and aiwf check raises blocking findings for untagged entities. - Lifecycle management: Fix tags with aiwf set-area, rename members repo-wide with aiwf rename-area, and acknowledge legitimate cross-cutting work with aiwf acknowledge mistag. - Use Case: You are about to fix a login bug in projects/app-a/auth/login.go but do not know the area name — pass the file path as --path-hint to aiwf add gap and the kernel derives area: app-a automatically. ## Quick Start Ask the AI to create an aiwf gap for a bug in a specific file using a path hint so the correct area is derived automatically.

Frequently Asked Questions about aiwf-area

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assign an area when creating an aiwf entity?

Pass --area with a declared member name to aiwf add, or pass --path-hint with a repo-relative file path so aiwf derives the area from the paths globs. Explicit --area always wins, and ambiguous hints set no area rather than guessing.

What is the paths glob in aiwf area configuration?

The paths glob in aiwf.yaml declares where an area's code lives, acting as an oracle so aiwf can verify tags against reality. Without paths, an area is a label-only tag and path-backed checks like mistag stay inert.

How do I fix a wrong or missing area tag on an entity?

Run aiwf set-area with the entity id and the correct member name to retag it. For legitimate cross-cutting work, use aiwf acknowledge mistag with a reason instead of retagging.

What happens when areas.required is set to true?

aiwf add refuses to create untagged root entities, and aiwf check raises a blocking area-required finding for any untagged root entity. Work belonging to no single project should be tagged with the reserved global sentinel.

Can I rename an area member in aiwf.yaml by hand?

No, hand-editing a member name orphans every entity still referencing the old label. Use aiwf rename-area with the old and new names, which rewrites the aiwf.yaml member and all referencing entities in one commit.