dev-workflows 0.3.0 → 0.5.0

package/README.md

@@ -6,7 +6,7 @@
 
 Define rules once. Compile them everywhere.
 
-A local-first CLI to define AI coding rules and compile them for every editor and agent.
+A local-first CLI to define AI coding rules, slash commands, templates, and hooks — compiled for every editor and agent.
 
 ---
 
@@ -14,21 +14,33 @@ A local-first CLI to define AI coding rules and compile them for every editor an
 
 ```bash
 npx dev-workflows init
-devw add react-conventions
+devw add typescript/strict
 devw compile
 ```
 
+Or bootstrap a full spec-driven workflow:
+
+```bash
+devw init --preset spec-driven -y
+```
+
 ---
 
 ## What it does
 
 ```
 .dwf/rules/*.yml        →  devw compile  →  CLAUDE.md
-                                             .cursor/rules
+                                             .cursor/rules/devworkflows.mdc
                                              GEMINI.md
+                                             .windsurf/rules/devworkflows.md
+                                             .github/copilot-instructions.md
+
+.dwf/assets/commands/*   →  devw compile  →  .claude/commands/*.md
+.dwf/assets/templates/*  →  devw compile  →  docs/specs/*.md
+.dwf/assets/hooks/*      →  devw compile  →  .claude/settings.local.json
 ```
 
-You define rules in YAML. The compiler generates each editor's native format. Change a rule, recompile — every editor stays in sync.
+You define rules in YAML and assets in Markdown/JSON. The compiler generates each editor's native format. Change a rule, recompile — every editor stays in sync.
 
 ---
 
@@ -37,29 +49,64 @@ You define rules in YAML. The compiler generates each editor's native format. Ch
 | Command | Description |
 |---------|-------------|
 | `devw init` | Initialize a `.dwf/` ruleset in your project |
-| `devw add <block>` | Install a prebuilt rule block |
-| `devw remove <block>` | Remove a rule block |
-| `devw compile` | Generate editor-specific rule files |
+| `devw init --preset <name>` | Initialize with a preset (e.g., `spec-driven`) |
+| `devw add <category>/<name>` | Install a rule from the registry |
+| `devw add command/<name>` | Install a slash command |
+| `devw add template/<name>` | Install a spec template |
+| `devw add hook/<name>` | Install an editor hook |
+| `devw add preset/<name>` | Install a preset (bundle of rules + assets) |
+| `devw remove <category>/<name>` | Remove a rule or asset |
+| `devw compile` | Generate editor configs and deploy assets |
 | `devw watch` | Watch `.dwf/` and recompile on changes |
-| `devw doctor` | Validate config and detect rule drift |
+| `devw doctor` | Validate config and detect drift |
 | `devw list rules` | List all active rules |
-| `devw list blocks` | List installed blocks |
+| `devw list assets` | List installed assets |
 | `devw list tools` | List configured editors |
 
 ---
 
-## Rule Blocks
+## Rules Registry
+
+Install rules from the registry with `devw add <category>/<rule>`.
+
+| Rule | Description |
+|------|-------------|
+| `typescript/strict` | Strict TypeScript patterns |
+| `javascript/react` | React component and hook conventions |
+| `javascript/nextjs` | Next.js App Router best practices |
+| `css/tailwind` | Utility-first styling conventions |
+| `testing/vitest` | Test naming and structure rules |
+| `security/supabase-rls` | Database security and RLS rules |
+| `security/auth-patterns` | Authentication best practices |
+| `frontend/design-guidelines` | UI/UX design conventions |
+| `frontend/accessibility` | Accessibility (a11y) rules |
+| `frontend/performance` | Frontend performance patterns |
+| `workflow/git-conventions` | Git commit and branch conventions |
+| `workflow/debugging` | Systematic debugging methodology |
+| `workflow/spec-driven` | Spec-driven development workflow |
+
+---
+
+## Assets
+
+Beyond rules, dev-workflows manages **assets** — slash commands, templates, and hooks that power AI workflows.
+
+| Asset | Type | Description |
+|-------|------|-------------|
+| `command/spec` | Command | Generate a feature spec through guided questions |
+| `command/plan` | Command | Create an implementation plan from a spec |
+| `command/build` | Command | Execute a plan step by step with verification |
+| `command/learn` | Command | Capture a lesson learned as a project rule |
+| `template/feature-spec` | Template | Markdown template for feature specifications |
+| `hook/auto-format` | Hook | Auto-format files after AI edits |
+
+### Presets
 
-Prebuilt rule blocks you can stack. Install with `devw add <block>`.
+Presets bundle rules and assets into a single install.
 
-| Block | Purpose |
-|-------|---------|
-| `typescript-strict` | Enforces strict TypeScript patterns |
-| `react-conventions` | Common React component and hook rules |
-| `nextjs-approuter` | Next.js App Router best practices |
-| `tailwind` | Utility-first styling conventions |
-| `supabase-rls` | Database security and RLS rules |
-| `testing-basics` | Test naming and structure rules |
+| Preset | Includes |
+|--------|----------|
+| `preset/spec-driven` | `workflow/spec-driven` rule + all 4 commands + feature-spec template + auto-format hook |
 
 ---
 
@@ -72,7 +119,7 @@ Bridges generate editor-compatible rule files. One adapter per tool.
 | Claude Code | `CLAUDE.md` |
 | Cursor | `.cursor/rules/devworkflows.mdc` |
 | Gemini CLI | `GEMINI.md` |
-| Windsurf | `.windsurfrules` |
+| Windsurf | `.windsurf/rules/devworkflows.md` |
 | VS Code Copilot | `.github/copilot-instructions.md` |
 
 ---
@@ -99,4 +146,4 @@ Issues and PRs welcome. If you find a bug or have an idea, [open an issue](https
 
 ## License
 
-MIT
+MIT

package/dist/bridges/types.d.ts

@@ -6,6 +6,12 @@ export interface Rule {
     tags?: string[];
     enabled: boolean;
     sourceBlock?: string;
+    source?: string;
+}
+export interface PulledEntry {
+    path: string;
+    version: string;
+    pulled_at: string;
 }
 export interface ProjectConfig {
     version: string;
@@ -16,6 +22,20 @@ export interface ProjectConfig {
     tools: string[];
     mode: 'copy' | 'link';
     blocks: string[];
+    pulled: PulledEntry[];
+    assets: AssetEntry[];
+}
+export declare const ASSET_TYPE: {
+    readonly Command: "command";
+    readonly Template: "template";
+    readonly Hook: "hook";
+};
+export type AssetType = typeof ASSET_TYPE[keyof typeof ASSET_TYPE];
+export interface AssetEntry {
+    type: AssetType;
+    name: string;
+    version: string;
+    installed_at: string;
 }
 export interface Bridge {
     id: string;

package/dist/bridges/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridges/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridges/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEnE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpE"}

package/dist/bridges/types.js

@@ -1,2 +1,6 @@
-export {};
+export const ASSET_TYPE = {
+    Command: 'command',
+    Template: 'template',
+    Hook: 'hook',
+};
 //# sourceMappingURL=types.js.map

package/dist/bridges/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridges/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridges/types.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/dist/commands/add.d.ts

@@ -1,7 +1,33 @@
 import type { Command } from 'commander';
+import { convert } from '../core/converter.js';
+import type { PulledEntry, AssetEntry, AssetType } from '../bridges/types.js';
+export declare const BACK_VALUE = "__back__";
+export declare function pluralRules(count: number): string;
 export interface AddOptions {
     list?: boolean;
     noCompile?: boolean;
+    force?: boolean;
+    dryRun?: boolean;
 }
+export declare function validateInput(input: string): {
+    category: string;
+    name: string;
+} | null;
+interface CachedRegistry {
+    categories: Array<{
+        name: string;
+        rules: Array<{
+            name: string;
+            description: string;
+        }>;
+    }>;
+}
+export declare function fetchRegistry(cwd: string): Promise<CachedRegistry | null>;
+export declare function generateYamlOutput(category: string, name: string, result: ReturnType<typeof convert>, pulledAt: string): string;
+export declare function updateConfig(cwd: string, entry: PulledEntry): Promise<void>;
+export declare function updateConfigAssets(cwd: string, entry: AssetEntry): Promise<void>;
+export declare function downloadAndInstallAsset(cwd: string, type: AssetType, name: string, options: AddOptions): Promise<boolean>;
+export declare function installPreset(cwd: string, presetName: string, options: AddOptions): Promise<boolean>;
 export declare function registerAddCommand(program: Command): void;
+export {};
 //# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAiGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQzD"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAO/C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAI9E,eAAO,MAAM,UAAU,aAAa,CAAC;AAErC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUtF;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD,CAAC,CAAC;CACJ;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAoD/E;AAuCD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,EAClC,QAAQ,EAAE,MAAM,GACf,MAAM,CA6BR;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBjF;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtF;AAOD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,OAAO,CAAC,CAwElB;AAiPD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,OAAO,CAAC,CAyDlB;AAuED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUzD"}