@fluentcommerce/ai-skills 0.1.0 → 0.3.0

package/content/dev/skills/fluent-feature-plan/PLAN_TEMPLATE.md

@@ -22,11 +22,13 @@ Every table row in every section of a plan carries a **Source** column. This mak
 
 ## Plan File Conventions
 
-**Account-scoped path:** `accounts/<PROFILE>/plans/<YYYY-MM-DD>-<skill-short-name>-<brief-slug>.md`
+**Feature plan path:** `accounts/<PROFILE>/features/<slug>/plan.md`
+
+**Task plan path:** `accounts/<PROFILE>/tasks/<YYYY-MM-DD>-<skill-short-name>-<brief-slug>.md`
 
 **Repo-scoped path:** `.fluent-ai-skills/plans/<YYYY-MM-DD>-<skill-short-name>-<brief-slug>.md`
 
-Use account-scoped when targeting a Fluent environment. Use repo-scoped for package-internal work.
+Use feature plan path for plans tied to a business feature (creates `status.json` alongside). Use task plan path for operational plans (module-scaffold, bootstrap, version-manage). Use repo-scoped for package-internal work.
 
 **Naming rules:**
 - `<PROFILE>` — active Fluent CLI profile (e.g., `HMDEV`, `SAGIRISH`)
@@ -53,9 +55,16 @@ Every plan file MUST follow this structure. Omit sections marked _optional_ when
 | Profile | <PROFILE> |
 | Retailer(s) | <RETAILER_REF> (ID: <N>) |
 | Module(s) | <module names if applicable> |
+| Business Spec | `accounts/<PROFILE>/features/<slug>/spec.md` |
 | Approved by | --- |
 | Revision | 1 |
 
+## Revision Log
+
+| Rev | Date | Change Type | Summary | Status Impact |
+|-----|------|-------------|---------|---------------|
+| v1 | YYYY-MM-DD | Initial | Initial plan | -- |
+
 ## Table of Contents
 
 1. [Business Context](#1-business-context)
@@ -189,6 +198,22 @@ flowchart TD
 > - Keep it high-level — show the routing and status flow, not individual rules within rulesets
 > - This diagram pairs with §6.1 Complete Workflow Inventory which shows the detail per ruleset
 
+### 3.7 Delta View (for features extending existing functionality) _(optional)_
+
+> When this plan modifies existing workflows or rulesets, show the before→after for each change:
+
+| Artifact | Before | After | Change Type |
+|----------|--------|-------|-------------|
+| ORDER::HD Ruleset "CreateFulfilment" | OOTB `CreateFulfilment` rule | Custom `CreateFulfilmentWithBulkySplit` | REPLACED |
+| ORDER::HD Status "PICK_PACK" | Transitions: AssignFulfilment | Transitions: AssignFulfilment, AssignBulkyFulfilment | MODIFIED |
+| Setting `BULKY_ATTRIBUTE_NAME` | (not present) | `isBulky` | NEW |
+
+> For **MODIFIED** artifacts: specify exactly what changes (added rule props, new transitions, changed parameters).
+> For **REPLACED** artifacts: name the old and new, explain why replacement is needed vs modification.
+> For **NEW** artifacts: mark as NEW, no "before" needed.
+
+> **Source classification reminder:** Every row in every table carries a Source column: NEW / EXISTING / MODIFIED / REUSED / OOTB. The Delta View supplements this by showing the actual before→after diff for MODIFIED and REPLACED items.
+
 ## 4. Workflows **[required]**
 
 | Workflow | Source | Current Ver | Action | Details |