@difflab/difflab-cli 0.9.0 → 0.10.0

package/README.md

@@ -66,7 +66,9 @@ difflab-cli templates list
 difflab-cli templates scaffold spec-driven-plan docs/plans first-plan.md --cwd /absolute/project/path
 ```
 
-The CLI defaults `--cwd` to its current directory. The MCP server exposes `template_list({})` and `scaffold({"name":"spec-driven-plan","cwd":"/absolute/project/path","path":"docs/plans","filename":"first-plan.md"})`. Both interfaces take a hyphenated template name, a relative destination **directory** (`path`, or `.` for `cwd`), and a separate **filename**. MCP always requires an absolute existing `cwd`. Missing destination directories are created. Available names: `spec-driven-plan`, `software-architecture-design`, `architecture-decision-record`, `product-requirements-document`, `code-review`, `planning-intent`, `ui-component-architecture`, `pull-request-description` (adapted from Diffpi's PR template), `flow-definition`, `flow-instance`, `exploration-summary`, `exploration-research`, `exploration-proposal`, and `poc-readme`.
+The CLI defaults `--cwd` to its current directory. The MCP server exposes `template_list({})` and `scaffold({"name":"spec-driven-plan","cwd":"/absolute/project/path","path":"docs/plans","filename":"first-plan.md"})`. Both interfaces take a hyphenated template name, a relative destination **directory** (`path`, or `.` for `cwd`), and a separate **filename**. MCP always requires an absolute existing `cwd`. Missing destination directories are created. Available names: `spec-driven-plan`, `software-architecture-design`, `architecture-decision-record`, `product-requirements-document`, `agents`, `code-review`, `planning-intent`, `ui-component-architecture`, `pull-request-description` (adapted from Diffpi's PR template), `flow-definition`, `flow-instance`, `exploration-summary`, `exploration-research`, `exploration-proposal`, and `poc-readme`.
+
+Use `difflab-cli templates scaffold agents . AGENTS.md --cwd /absolute/project/path` to start repository guidance. Fill the prompts with known rules and remove unused prompts. The template separates Hard Rules, Organization, Style, and Testing. Hard Rules name required task runners and repository tools. Organization separates directory layout from section headers, code ordering, and grouping within files. Review addressing saves explicit user repository rules immediately and marks inferred or uncertain rules with `[Proposed]`. It asks before reorganizing existing guidance to match the template and adapts the existing structure if permission is declined. It retains terse file-level organization rules and keeps guidance within 500 soft-wrapped source lines.
 
 On first use, missing bundled templates and filled examples are copied to `~/.difflab/templates` and `~/.difflab/templates/examples`. Edit the installed templates to customize future documents. Later runs add missing files but never replace existing ones, even after an upgrade. Examples are for reference, not selectable templates. Copying is literal: prompts and placeholders are not substituted. An unknown name, missing or invalid source, unsafe path, symlink, or existing destination causes an error; destination files are never overwritten. The target directory must remain inside `cwd` and the filename must be a single file name without separators. The one symlink exception is an initialized repository's `.difflab` link to its own user project store: `templates scaffold spec-driven-plan .difflab/plans/YYMMDD-name PLAN.md --cwd /absolute/repo` works in Git worktrees as well. To restore a bundled default, move your installed copy aside before listing again.
 

package/dist/index.js

@@ -48618,6 +48618,45 @@ var product_requirements_document_default = `# [User outcome or product change]
 `;
 var init_product_requirements_document = () => {};
 
+// templates/agents.md
+var agents_default = `# Repository Guidance
+
+<!-- Fill the prompts with known repository rules and remove unused prompts. Write terse, imperative bullets in simple English. Use soft wrapping and keep the whole file at or below 500 source lines, including headings and blank lines. Replace contradictory rules, merge duplicates, and prune less important guidance when adding rules. Prefix inferred or uncertain rules with [Proposed]; omit the prefix only for rules the user explicitly asks to add or says must always apply in this repo. Link to maintained docs for details; omit architecture explanations, README repetition, and code snippets. -->
+
+## Hard Rules
+
+- Prefer the repository's existing task-runner tasks. See [task definitions](path-to-task-definitions).
+- [State required scaffolding and repository management tools. Link to their configuration.]
+- [Add other essential repository constraints.]
+
+## Organization
+
+### Repository layout
+
+- [State directory layout and file naming conventions. Link to maintained docs for details.]
+
+### File layout
+
+- [State prescribed section headers, code ordering, and grouping within each file type.]
+- [Retain terse rules for import, type, API, hook, and helper placement.]
+
+## Style
+
+### Languages
+
+- [Replace this heading with each language used here and add its rules.]
+
+### Frameworks
+
+- [Replace this heading with each framework that needs specific rules.]
+
+## Testing
+
+- [State where unit, integration, and end-to-end tests belong.]
+- [State test naming, structure, shared helper, and validation rules. Link to task definitions.]
+`;
+var init_agents = () => {};
+
 // templates/code-review.md
 var code_review_default = `# Review: [change or pull request]
 
@@ -49701,12 +49740,13 @@ Add invitation resend and cancellation in a separate change.
 var init_pull_request_feature = () => {};
 
 // src/templates/source.ts
-var catalog, contents, embeddedSource;
+var contents, catalog, embeddedSource;
 var init_source = __esm(() => {
   init_spec_driven_plan();
   init_software_architecture_design();
   init_architecture_decision_record();
   init_product_requirements_document();
+  init_agents();
   init_code_review();
   init_planning_intent();
   init_ui_component_architecture();
@@ -49727,27 +49767,12 @@ var init_source = __esm(() => {
   init_component_dialog();
   init_component_navigation();
   init_pull_request_feature();
-  catalog = [
-    { name: "spec-driven-plan", description: "Spec-driven implementation plan" },
-    { name: "software-architecture-design", description: "Software architecture design" },
-    { name: "architecture-decision-record", description: "Architecture decision record" },
-    { name: "product-requirements-document", description: "Product requirements document" },
-    { name: "code-review", description: "Thorough code review" },
-    { name: "planning-intent", description: "Planning intent for a user to fill in" },
-    { name: "ui-component-architecture", description: "UI component design and implementation" },
-    { name: "pull-request-description", description: "Draft pull request description" },
-    { name: "flow-definition", description: "Reusable global Agent Skill flow definition" },
-    { name: "flow-instance", description: "Frozen repository-local flow run" },
-    { name: "exploration-summary", description: "Source-grounded technical exploration summary" },
-    { name: "exploration-research", description: "Technical exploration research notes" },
-    { name: "exploration-proposal", description: "Optional technical exploration approach" },
-    { name: "poc-readme", description: "Disposable proof-of-concept branch README" }
-  ];
   contents = {
     "spec-driven-plan.md": spec_driven_plan_default,
     "software-architecture-design.md": software_architecture_design_default,
     "architecture-decision-record.md": architecture_decision_record_default,
     "product-requirements-document.md": product_requirements_document_default,
+    "agents.md": agents_default,
     "code-review.md": code_review_default,
     "planning-intent.md": planning_intent_default,
     "ui-component-architecture.md": ui_component_architecture_default,
@@ -49769,6 +49794,23 @@ var init_source = __esm(() => {
     "examples/component-navigation.md": component_navigation_default,
     "examples/pull-request-feature.md": pull_request_feature_default
   };
+  catalog = [
+    { name: "spec-driven-plan", description: "Spec-driven implementation plan" },
+    { name: "software-architecture-design", description: "Software architecture design" },
+    { name: "architecture-decision-record", description: "Architecture decision record" },
+    { name: "product-requirements-document", description: "Product requirements document" },
+    { name: "agents", description: "Concise repository rules for AGENTS.md" },
+    { name: "code-review", description: "Thorough code review" },
+    { name: "planning-intent", description: "Planning intent for a user to fill in" },
+    { name: "ui-component-architecture", description: "UI component design and implementation" },
+    { name: "pull-request-description", description: "Draft pull request description" },
+    { name: "flow-definition", description: "Reusable global Agent Skill flow definition" },
+    { name: "flow-instance", description: "Frozen repository-local flow run" },
+    { name: "exploration-summary", description: "Source-grounded technical exploration summary" },
+    { name: "exploration-research", description: "Technical exploration research notes" },
+    { name: "exploration-proposal", description: "Optional technical exploration approach" },
+    { name: "poc-readme", description: "Disposable proof-of-concept branch README" }
+  ];
   embeddedSource = {
     catalog,
     assets: Object.keys(contents),
@@ -50134,7 +50176,7 @@ function agentAdapter(name) {
   return Object.hasOwn(agentAdapters, name) ? agentAdapters[name] : undefined;
 }
 var agentAdapters, agentNames;
-var init_agents = __esm(() => {
+var init_agents2 = __esm(() => {
   init_adapter();
   init_claude_code();
   init_codex();
@@ -50177,7 +50219,7 @@ async function setupMcpClients(clients, write) {
   write("Restart or reload the selected client to use the Difflab MCP tools.");
 }
 var init_setup = __esm(() => {
-  init_agents();
+  init_agents2();
 });
 
 // src/mcp/index.ts
@@ -52324,7 +52366,7 @@ function createProgram(write = console.log, version = "0.1.0", options = {}) {
 
 // src/index.ts
 init_errors3();
-var version2 = "0.9.0";
+var version2 = "0.10.0";
 try {
   await createProgram(console.log, version2).parseAsync(process.argv);
 } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@difflab/difflab-cli",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "private": false,
   "description": "A minimal Bun CLI starter built with Commander",
   "license": "Apache-2.0",