fpf-skilldesign-mint-name
Generated skill for design/mint-name.
When & Why to Use This Skill
The fpf-skill:design-mint-name is a specialized tool that automates the F.18 Name Card process from the First Principles Framework (FPF). It is designed to 'mint' high-quality names for concepts, artifacts, and repositories, ensuring they possess high semantic fidelity and cognitive ergonomics. By utilizing a rigorous 7-step semantic read-through and a matrix-based evaluation, this skill helps teams move beyond arbitrary naming toward a structured, logical, and descriptive nomenclature system.
Use Cases
- Naming new software repositories or microservices to ensure the technical ID and plain English label accurately reflect their strict function.
- Developing precise terminology for new architectural components or internal tools to maintain linguistic consistency across engineering teams.
- Validating proposed product or feature names against semantic 'sense-seeds' to identify if a name is too narrow, too wide, or conceptually flawed.
- Creating standardized 'Name Cards' that document the context, purpose, and minimal definitional statement (MDS) for organizational artifacts.
- Refining technical documentation by replacing ambiguous jargon with 'minted' names that have been tested for cognitive ergonomics.
| name | fpf-skill:design-mint-name |
|---|---|
| description | Generated skill for design/mint-name. |
| version | 0.1.0 |
| allowed_tools | [] |
design/mint-name Kernel
Context
This skill enacts the F.18 Name Card process from the First Principles Framework (FPF). It is used to "mint" new names for concepts, artifacts, or repositories ensuring high semantic fidelity and cognitive ergonomics.
Metadata
- ID:
fpf-skill:design-mint-name - Pattern Ref: F.18 (Name Card)
- Role:
Namer - Version: 0.1.0
Instructions
Step 1: Define the Context
- Identify the Bounded Context: Where does this name live? (e.g., "Skill Repo", "Runtime Kernel").
- State the Purpose: What is the strict function of the thing being named?
Step 2: Generate Candidates
Propose 3-5 candidates. For each, define:
- Twin Labels: Technical ID (kebab-case) and Plain English.
- Minimal Definitional Statement (MDS): A strict definition of what the thing IS.
Step 3: Run P2 Semantic Read-Through
For each candidate, test it against the 7 standard FPF sense-seeds (S1–S7):
- S1 Add: "Add a new
<Thing>..." - S2 Retrieve: "Get a
<Thing>from..." - S3 Teach: "Teach the concept of
<Thing>..." - S4 Provenance: "Trace the
<Thing>back to..." - S5 Relations: "Link
<Thing>to..." - S6 Rep-Change: "Change format of
<Thing>..." - S7 Non-Native: "Add a foreign
<Thing>..."
Step 4: Tally the Matrix
Mark each test as:
- TN: Too Narrow
- OT: On Target
- TW: Too Wide
- WP: Wrong Prototype
Step 5: Mint the Card
Select the candidate with the highest OT count (and 0 WP). Output the final Name Card in Markdown format.
F.18 Name Card Template
A minted name card must include:
- CardMode: (e.g. MintNew)
- Row ID: (e.g. RN.FPF.SKILLREPO.001)
- Context of Meaning
- Kind
- Purpose / use-domain
- Minimal Definitional Statement (MDS)
- Didactic subtitle
- Sense reference
- Archetypal situations (sense-seeds)
- P2 Matrix Tally