gcf-aif-ext 0.2.5 → 0.3.0

package/templates/card.md

@@ -1,29 +1,46 @@
 ---
-schema: 1
-id: card-000
-slug: example
+schema: 2
+id: example
+type: mechanic
 status: proposed
-route: soft
 system: [example-system]
 depends: []
+pillars: []
 source: manual
 tune_count: 0
 built_at: null
 created: "2026-01-01"
 ---
 
+intent:
+- the player crosses short gaps without breaking the pace of a fight
+
 behavior:
-- player presses X -> the character does Y -> the screen shows Z
+- input: the player presses X
+  state: the character moves a short distance forward
+  feedback: the screen shows a short trail behind the character
+
+refusal:
+- pressing X during the cooldown does nothing and plays no sound
+
+boundaries:
+- a dash into a wall stops at the wall
+
+persistence: none: a dash leaves no state behind
+
+feel_like: like Hades, not like Celeste
+
+feel:
+- name: duration
+  envelope: 0.15..0.25 s
+
+- name: cooldown
+  envelope: 0.4..0.8 s
 
 contract:
 - new components and systems live under Assets/Scripts/Example/
 - data flows from input to simulation, never backwards
 
-feel:
-- like Hades, not like Celeste
-- duration 0.15..0.25 s
-- cooldown 0.4..0.8 s
-
 interactions:
 - none: this example crosses no existing mechanic
 

package/templates/cnlp.config.json

@@ -1,7 +1,6 @@
 {
   "profiles": ".ai-factory/extensions/gcf-aif-ext/profiles",
   "corpus": [
-    { "profile": "card", "glob": "gcf/cards/*.md" },
     { "profile": "system", "glob": "gcf/systems/*.md" },
     { "profile": "pillars", "glob": "gcf/PILLARS.md" }
   ]

package/templates/design.md

@@ -0,0 +1,59 @@
+# example-system
+
+purpose:
+- holds the example mechanic and the rule it rests on
+
+## example-dash
+
+type: mechanic
+title: dash
+route: soft (acceptance is the feel of the move)
+system: [example-system]
+milestone: TBD
+pillars: TBD
+depends: [example-grid]
+source: manual
+
+intent:
+- the player crosses short gaps without breaking the pace of a fight
+
+behavior:
+- input: the player presses X
+  state: the character moves a short distance forward
+  feedback: TBD
+
+refusal:
+- pressing X during the cooldown does nothing
+
+boundaries: TBD
+
+persistence: none: a dash leaves no state behind
+
+feel_like: like Hades, not like Celeste
+
+feel:
+- name: duration
+  envelope: 0.15..0.25 s
+
+constraints:
+- do not add a new input binding
+
+miss_criterion: TBD
+
+## example-grid
+
+type: rule
+title: example grid
+route: hard (a structural invariant, unit-testable)
+system: [example-system]
+milestone: TBD
+pillars: TBD
+depends: none
+source: manual
+
+statement:
+- grid cells per side in {4, 6, 8}
+- the grid never scrolls
+
+check:
+- a unit test over the level data

package/templates/game.md

@@ -0,0 +1,24 @@
+logline: a short-session puzzle about placing tiles on a small board
+
+platforms:
+- web portals and mobile browsers, touch and mouse
+
+audience:
+- TBD
+
+references:
+- like a tabletop logic puzzle, not like a match-three game
+
+scope_in:
+- the core puzzle with one short win animation
+
+scope_out:
+- story, cutscenes and dialogue
+
+milestones:
+- name: web
+  goal: validate the core puzzle on a live audience
+  content: campaign levels = 50
+
+- name: steam
+  goal: a long campaign once the web version proves the puzzle keeps players

package/templates/glossary.md

@@ -0,0 +1,11 @@
+terms:
+- term: tile tray
+  means: the supply of unplaced tiles the player picks from
+  not: hand, table
+
+- term: void cell
+  means: a cell a shaped board leaves out
+  not: blocked cell
+
+units:
+- coins: the soft currency

package/templates/system.md

@@ -1,6 +1,6 @@
 ---
 system: example-system
-updated_by: card-000
+updated_by: example
 ---
 
 purpose:

package/profiles/card.md

@@ -1,65 +0,0 @@
----
-name: card
-description: The CNL-P profile of a GCF feature card — the six slots a card body carries, in order.
----
-
-format: cnlp-format.md
-
-mood: declarative
-
-headings:
-- none: the body is flat and the document is named by its frontmatter or its fixed path
-
-frontmatter_fields:
-- schema
-- id
-- slug
-- status
-- route
-- system
-- depends
-- source
-- tune_count
-- built_at
-- created
-
-lexicon_exempt:
-- none: every field of a card body is read at planning time and must stay unambiguous
-
-sections:
-- key: behavior
-  form: bullet-list
-  required: yes
-  note: player input -> state change -> feedback, one observable statement per line
-
-- key: contract
-  form: bullet-list
-  required: yes
-  note: entities, components and data flows the feature adds; paths and entry points, never member lists or values
-
-- key: feel
-  form: bullet-list
-  required: yes
-  note: a comparison line (like X, not like Y) plus envelope lines; envelopes are the only legal numbers in gcf documents
-
-- key: interactions
-  form: bullet-list
-  required: yes
-  note: existing mechanics this feature crosses; a soft line may end with an "[until: ...]" annotation
-
-- key: constraints
-  form: bullet-list
-  required: yes
-  note: negative constraints, one prohibition per line, checkable by an analyzer or a reviewer
-
-- key: miss_criterion
-  form: scalar
-  required: yes
-  note: the one question the game in hand answers; the human answers it at the verdict
-
-custom_sections:
-- none: a card block that is not listed above is prose looking for a home
-
-enforcement:
-- `npx cnlp check`, over the files a `cnlp.config.json` corpus entry maps to this profile
-- frontmatter is validated separately by `schemas/card.schema.json` in the gcf pre-commit hook