@produck/agent-toolkit 0.7.0 → 0.8.0

package/bin/build-publish-assets.mjs

@@ -12,8 +12,10 @@ const SOURCE_TOOLING_BASELINE_PATH = path.resolve(SOURCE_DIR, 'tooling-version-b
 const OUTPUT_TOOLING_BASELINE_PATH = path.resolve(OUTPUT_DIR, 'tooling-version-baseline.json');
 const SOURCE_GITATTRIBUTES_PATH = path.resolve(REPO_ROOT, '.gitattributes');
 const SOURCE_GITIGNORE_PATH = path.resolve(REPO_ROOT, '.gitignore');
+const SOURCE_PRETTIERIGNORE_PATH = path.resolve(REPO_ROOT, '.prettierignore');
 const OUTPUT_GITATTRIBUTES_PATH = path.resolve(PACKAGE_ROOT, 'publish-assets/gitattributes');
 const OUTPUT_GITIGNORE_PATH = path.resolve(PACKAGE_ROOT, 'publish-assets/gitignore');
+const OUTPUT_PRETTIERIGNORE_PATH = path.resolve(PACKAGE_ROOT, 'publish-assets/prettierignore');
 const LEGACY_OUTPUT_PATH = path.resolve(
   PACKAGE_ROOT,
   'publish-assets/instructions/org.instructions.md',
@@ -77,12 +79,19 @@ function readAndValidateToolingBaseline() {
     throw new Error(`Invalid coverage.scriptTemplate in: ${SOURCE_TOOLING_BASELINE_PATH}`);
   }
 
-  if (!coverageScriptTemplate.includes('{c8.version}')) {
-    throw new Error(
-      `coverage.scriptTemplate must include {c8.version} in: ${SOURCE_TOOLING_BASELINE_PATH}`,
-    );
+  const eslintRulesPkgPath = path.resolve(PACKAGE_ROOT, '../eslint-rules/package.json');
+  if (fs.existsSync(eslintRulesPkgPath)) {
+    const eslintRulesPkg = JSON.parse(fs.readFileSync(eslintRulesPkgPath, 'utf8'));
+    const version = eslintRulesPkg.version;
+    if (typeof version === 'string' && version.trim()) {
+      if (!baseline.tools) baseline.tools = {};
+      baseline.tools['@produck/eslint-rules'] = {
+        version,
+        policy: 'pinned',
+        allowLatest: false,
+      };
+    }
   }
-
   return `${JSON.stringify(baseline, null, 2)}\n`;
 }
 
@@ -154,6 +163,9 @@ function run() {
   if (!fs.existsSync(SOURCE_GITIGNORE_PATH)) {
     throw new Error(`Missing source .gitignore: ${SOURCE_GITIGNORE_PATH}`);
   }
+  if (!fs.existsSync(SOURCE_PRETTIERIGNORE_PATH)) {
+    throw new Error(`Missing source .prettierignore: ${SOURCE_PRETTIERIGNORE_PATH}`);
+  }
 
   fs.writeFileSync(
     OUTPUT_GITATTRIBUTES_PATH,
@@ -171,6 +183,15 @@ function run() {
   );
   process.stdout.write(`Generated ${OUTPUT_GITIGNORE_PATH} from ${SOURCE_GITIGNORE_PATH}\n`);
 
+  fs.writeFileSync(
+    OUTPUT_PRETTIERIGNORE_PATH,
+    normalize(fs.readFileSync(SOURCE_PRETTIERIGNORE_PATH, 'utf8')),
+    'utf8',
+  );
+  process.stdout.write(
+    `Generated ${OUTPUT_PRETTIERIGNORE_PATH} from ${SOURCE_PRETTIERIGNORE_PATH}\n`,
+  );
+
   cleanStaleManagedFiles(expectedNames);
 
   if (fs.existsSync(LEGACY_OUTPUT_PATH)) {

package/bin/command/sync-format/help.txt

@@ -4,9 +4,11 @@ Usage:
 
 Behavior:
   - Applies organization-required root format script:
-    - scripts.produck:format = prettier --write .
+    - scripts.produck:format = prettier --write . --ignore-path .prettierignore --ignore-path .gitignore
   - Applies organization-required root Prettier config file:
     - .prettierrc
+  - Applies organization-required root Prettier ignore file:
+    - .prettierignore (prettier-specific patterns; .gitignore is also used via --ignore-path)
 
 Rules:
   - --check validates without writing and exits non-zero on mismatch

package/bin/command/sync-format/index.mjs

@@ -14,10 +14,17 @@ const TOOLING_BASELINE_CANDIDATE_PATHS = [
   path.resolve(PACKAGE_ROOT, 'publish-assets/instructions/produck/tooling-version-baseline.json'),
 ];
 const PRETTIER_CONFIG_FILE = '.prettierrc';
+const PRETTIER_IGNORE_FILE = '.prettierignore';
 const REQUIRED_PRETTIER_DEV_DEPENDENCY_KEY = 'prettier';
 
+const PRETTIER_IGNORE_SOURCE_CANDIDATE_PATHS = [
+  path.resolve(REPO_ROOT, '.prettierignore'),
+  path.resolve(PACKAGE_ROOT, 'publish-assets/prettierignore'),
+];
+
 const REQUIRED_FORMAT_SCRIPT_KEY = 'produck:format';
-const REQUIRED_FORMAT_SCRIPT_VALUE = 'prettier --write .';
+const REQUIRED_FORMAT_SCRIPT_VALUE =
+  'prettier --write . --ignore-path .prettierignore --ignore-path .gitignore';
 const REQUIRED_PRETTIER_CONFIG = `${JSON.stringify(
   {
     semi: true,
@@ -33,6 +40,23 @@ const REQUIRED_PRETTIER_CONFIG = `${JSON.stringify(
   2,
 )}\n`;
 
+function loadPrettierIgnoreContent() {
+  const sourcePath = PRETTIER_IGNORE_SOURCE_CANDIDATE_PATHS.find((p) => fs.existsSync(p));
+
+  if (!sourcePath) {
+    console.error('Org .prettierignore source not found in expected locations:');
+    for (const p of PRETTIER_IGNORE_SOURCE_CANDIDATE_PATHS) {
+      console.error(`- ${p}`);
+    }
+    process.exit(2);
+  }
+
+  return {
+    sourcePath,
+    content: fs.readFileSync(sourcePath, 'utf8'),
+  };
+}
+
 export function printSyncFormatHelp() {
   printTextResource(HELP_FILE);
 }
@@ -101,6 +125,8 @@ export function runSyncFormat(options) {
   const pkg = parseJsonFile(rootPackageJsonPath, 'Root package.json');
   const toolingBaseline = loadToolingBaseline();
   const requiredPrettierVersion = toolingBaseline.prettierVersion;
+  const { sourcePath: prettierIgnoreSourcePath, content: REQUIRED_PRETTIER_IGNORE_CONTENT } =
+    loadPrettierIgnoreContent();
   const scripts =
     pkg.scripts && typeof pkg.scripts === 'object' && !Array.isArray(pkg.scripts)
       ? { ...pkg.scripts }
@@ -122,14 +148,20 @@ export function runSyncFormat(options) {
       : null;
 
   const prettierConfigPath = path.resolve(cwd, PRETTIER_CONFIG_FILE);
+  const prettierIgnorePath = path.resolve(cwd, PRETTIER_IGNORE_FILE);
   const previousPrettierConfig = readFileIfExists(prettierConfigPath);
+  const previousPrettierIgnore = readFileIfExists(prettierIgnorePath);
 
   const matchesRequiredFormat = previousFormat === REQUIRED_FORMAT_SCRIPT_VALUE;
   const matchesRequiredPrettierConfig = previousPrettierConfig === REQUIRED_PRETTIER_CONFIG;
   const matchesRequiredPrettierDep = previousPrettierDep === requiredPrettierVersion;
+  const matchesRequiredPrettierIgnore = previousPrettierIgnore === REQUIRED_PRETTIER_IGNORE_CONTENT;
 
   const requiresUpdate =
-    !matchesRequiredFormat || !matchesRequiredPrettierConfig || !matchesRequiredPrettierDep;
+    !matchesRequiredFormat ||
+    !matchesRequiredPrettierConfig ||
+    !matchesRequiredPrettierDep ||
+    !matchesRequiredPrettierIgnore;
 
   if (mode === 'sync' && requiresUpdate) {
     scripts[REQUIRED_FORMAT_SCRIPT_KEY] = REQUIRED_FORMAT_SCRIPT_VALUE;
@@ -140,6 +172,7 @@ export function runSyncFormat(options) {
 
     fs.writeFileSync(rootPackageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
     fs.writeFileSync(prettierConfigPath, REQUIRED_PRETTIER_CONFIG, 'utf8');
+    fs.writeFileSync(prettierIgnorePath, REQUIRED_PRETTIER_IGNORE_CONTENT, 'utf8');
   }
 
   const report = {
@@ -152,17 +185,22 @@ export function runSyncFormat(options) {
       formatScriptKey: REQUIRED_FORMAT_SCRIPT_KEY,
       formatScriptValue: REQUIRED_FORMAT_SCRIPT_VALUE,
       prettierConfigPath: path.relative(cwd, prettierConfigPath),
+      prettierIgnorePath: path.relative(cwd, prettierIgnorePath),
+      prettierIgnoreSourcePath,
       managedDevDependencies: { [REQUIRED_PRETTIER_DEV_DEPENDENCY_KEY]: requiredPrettierVersion },
     },
     status: {
       matchesRequiredFormatBefore: matchesRequiredFormat,
       matchesRequiredPrettierConfigBefore: matchesRequiredPrettierConfig,
       matchesRequiredPrettierDepBefore: matchesRequiredPrettierDep,
+      matchesRequiredPrettierIgnoreBefore: matchesRequiredPrettierIgnore,
       matchesRequiredFormatAfter: requiresUpdate && mode === 'sync' ? true : matchesRequiredFormat,
       matchesRequiredPrettierConfigAfter:
         requiresUpdate && mode === 'sync' ? true : matchesRequiredPrettierConfig,
       matchesRequiredPrettierDepAfter:
         requiresUpdate && mode === 'sync' ? true : matchesRequiredPrettierDep,
+      matchesRequiredPrettierIgnoreAfter:
+        requiresUpdate && mode === 'sync' ? true : matchesRequiredPrettierIgnore,
       updated: requiresUpdate && mode === 'sync',
     },
   };

package/bin/command/sync-instructions/index.mjs

@@ -88,7 +88,7 @@ export function runSyncInstructions(options) {
   const cwd = path.resolve(getSingle(options, '--cwd', process.cwd()));
   const outArg = getSingle(options, '--out', DEFAULT_NAMESPACE_OUT_DIR);
   const sourceArg = getSingle(options, '--source', '');
-  const force = hasFlag(options, '--force');
+  const force = true;
   const dryRun = hasFlag(options, '--dry-run');
   const prune = hasFlag(options, '--prune');
 
@@ -146,15 +146,6 @@ export function runSyncInstructions(options) {
   if (outLooksLikeFile) {
     const entry = entries[0];
     const exists = fs.existsSync(outPath);
-    if (exists && !force) {
-      const current = fs.readFileSync(outPath, 'utf8');
-      if (current !== entry.content) {
-        console.error(`Target already exists: ${outPath}`);
-        console.error('Use --force to overwrite.');
-        process.exit(2);
-      }
-    }
-
     const report = {
       mode: 'single-file',
       cwd,
@@ -162,18 +153,16 @@ export function runSyncInstructions(options) {
       source: sourceResolved,
       outPath,
       exists,
-      overwritten: exists && force,
+      overwritten: exists,
       dryRun,
       prune: false,
       initializedUserSpaceEntry: false,
       userSpaceEntryPath: null,
     };
-
     if (dryRun) {
       process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
       process.exit(0);
     }
-
     fs.mkdirSync(path.dirname(outPath), { recursive: true });
     fs.writeFileSync(outPath, entry.content, 'utf8');
     process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
@@ -202,15 +191,6 @@ export function runSyncInstructions(options) {
   }
 
   const toWrite = planned.filter((item) => !unchanged.includes(item.targetPath));
-  const conflicts = toWrite.filter((item) => fs.existsSync(item.targetPath));
-  if (conflicts.length > 0 && !force) {
-    console.error('Some target files already exist and would change:');
-    for (const item of conflicts) {
-      console.error(`- ${item.targetPath}`);
-    }
-    console.error('Use --force to overwrite.');
-    process.exit(2);
-  }
 
   const pruneDeletes = [];
   if (prune && fs.existsSync(outDir)) {

package/bin/command/sync-publish/index.mjs

@@ -11,7 +11,7 @@ const LERNA_CONFIG_FILE = 'lerna.json';
 
 const REQUIRED_PUBLISH_CHECK_SCRIPT_KEY = 'produck:publish:check';
 const REQUIRED_PUBLISH_CHECK_SCRIPT_VALUE =
-  'npm run produck:format && npm run produck:lint && npm run produck:coverage';
+  'npm run produck:install && npm run produck:format && npm run produck:lint && npm run produck:coverage';
 const USER_PUBLISH_SCRIPT_KEY = 'publish';
 const REQUIRED_PUBLISH_SCRIPT_KEY = 'produck:publish';
 const REQUIRED_PUBLISH_SCRIPT_FALLBACK_VALUE = 'npm run produck:publish:check && lerna publish';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@produck/agent-toolkit",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Central CLI toolkit for organization AI execution workflows",
   "type": "module",
   "repository": {
@@ -30,5 +30,5 @@
   "devDependencies": {
     "c8": "11.0.0"
   },
-  "gitHead": "61467ec369911fde65adc21bcf0c507c24735d90"
+  "gitHead": "a9e160249f664b28fa5971246e61d9e641c16586"
 }

package/publish-assets/instructions/produck/00-produck-base.instructions.md

@@ -18,20 +18,26 @@ in the `produck` organization.
 
 ## Instruction source split
 
-To separate organization-only governance from downstream-distributable
-baseline, policy sources are split as follows:
-
-- Downstream-distributable source:
-  `.github/distribution/produck/*.instructions.md`
-- Organization-only source (not distributed):
-  `.github/instructions/produck/*.instructions.md`
-
-Editing rule:
+Path semantics differ between the upstream policy repository and downstream
+repositories:
+
+- Upstream policy repository (this `produck/.github` repo):
+  - `.github/distribution/produck/*.instructions.md` — canonical baseline,
+    distributed to downstream repositories.
+  - `.github/instructions/produck/*.instructions.md` — reserved for
+    organization-only governance that should NOT be distributed.
+- Downstream repositories (consumers of the baseline):
+  - `.github/instructions/produck/*.instructions.md` — synced copy of the
+    upstream canonical baseline (managed by `agent-toolkit sync-instructions`).
+  - `.github/copilot-instructions.md` — repository-specific exceptions and
+    stricter local constraints.
+
+Editing rule (upstream only):
 
 - Update downstream baseline rules directly in
   `.github/distribution/produck/*.instructions.md`.
-- Update organization-only workflow/governance in
-  `.github/instructions/produck/`.
+- Add organization-only governance under
+  `.github/instructions/produck/` only when it must not be distributed.
 
 ## Default expectations
 
@@ -134,27 +140,15 @@ max_line_length = 80
 
 ## Commit and PR conventions
 
-- Commit messages use bracketed tags: `[TAG] summary`.
-- Every non-empty commit message line must start with `[TAG]`.
-- Empty lines are not allowed between commit message lines.
-- Do not use untagged bullet lines in commit message body.
-- If details are needed, use additional tagged lines.
-- Do not keep summary as an untagged standalone line.
-- Recommended local validation:
-  `npm exec -- agent-toolkit validate-commit-msg --file <message-file>`.
-- Commit precheck policy follows
+- Commit and commit-precheck rules are defined in
   `.github/distribution/produck/20-produck-commit.instructions.md`.
-- Canonical source for commit tag/target whitelists, legacy mapping, and
-  target syntax is
-  `.github/distribution/produck/20-produck-commit.instructions.md`.
-- Do not redefine commit tag or target whitelists in other instruction files.
-- For non-monorepo repositories, use `[TAG] summary` directly (no
-  package/workspace section headers).
-- Bracketed commit summaries should be in English
-- PR title format is repository-defined; no organization-level title format
-  restriction
-- In PR descriptions, summarize what changed, why it changed, how it was
-  validated, and any known risks or follow-up work
+- Use commit message validator before commit and amend:
+  `npm exec -- agent-toolkit validate-commit-msg --file <message-file>`.
+- Do not redefine commit tag, target, or monorepo section rules outside
+  `20-produck-commit.instructions.md`.
+- PR title format is repository-defined (no organization-level restriction).
+- PR descriptions should summarize what changed, why, validation, and known
+  risks or follow-up work.
 
 ## Terminal long-output protocol
 
@@ -255,7 +249,8 @@ locally in downstream repositories at a fixed version managed by the
 organization baseline.
 
 - Local install and pinned version are deployed by
-  `agent-toolkit sync-husky-hooks`.
+  `agent-toolkit sync-git` (root devDependency pinning) and
+  `agent-toolkit sync-install` (root install script baseline).
 - Invocation uses the locally installed copy:
   `npm exec -- <bin> ...`.
 - Do not use `npm exec --package=<pkg>@latest` for routine invocations.
@@ -294,31 +289,21 @@ Rollback runbook (minimum):
 
 ### Recommended organization AI instruction template
 
-Use the following template text in organization AI instructions:
-
-- Use Chinese for discussion unless repository rules require another language.
-- Follow existing repository patterns; do not invent APIs, files, commands, or
-  config keys.
-- Node-first execution policy:
-  - Use Node scripts first for file/path/output processing.
-  - For large output tasks, use two phases: capture full output, then analyze.
-  - Avoid fragile shell pipeline post-processing for long-output commands.
-- Central package policy:
-  - Central package is installed locally at a fixed organization-baseline version.
-  - Invoke via `npm exec -- <bin> ...` to use the locally installed copy.
-  - Print resolved package version before high-impact execution.
-  - Use dry-run first for risky operations; keep rollback path to pinned version.
-- Commit message policy:
-  - Every non-empty commit message line must start with `[TAG]`.
-  - Empty lines are not allowed between commit message lines.
-  - Use only allowed tags: `[INIT]`, `[ADD]`, `[REMOVE]`, `[FIX]`,
-    `[REFACTOR]`, `[UPGRADE]`.
-  - Optional target syntax is `[TAG] <target>: <summary>` with target in:
-    `docs`, `test`, `ci`, `deps`, `api`, `schema`, `infra`, `fmt`.
-- Do not assume scripts from organization `.github` repository exist in target
-  repositories.
-- If a repository provides stricter rules, repository rules override
-  organization defaults.
+When authoring organization-level AI instruction text (for example in
+organization settings), reference the canonical sources in this baseline
+instead of duplicating their content:
+
+- Language and default expectations: see `Default expectations` and
+  `Language conventions` sections above.
+- Node-first execution policy: see `Terminal long-output protocol` above.
+- Central package policy: see `Central package execution policy` above.
+- Commit message policy: see
+  [Commit Convention](20-produck-commit.instructions.md) (canonical source
+  for tag whitelist, target whitelist, and validator usage).
+- Cross-repository assumptions: do not assume scripts from the organization
+  `.github` repository exist in target repositories.
+- Precedence: repository-specific stricter rules override organization
+  defaults.
 
 ## Precedence
 
@@ -326,4 +311,5 @@ If a repository provides more specific instructions, follow the repository
 instructions over this organization baseline.
 
 For Node.js repositories, also follow [Node.js Initialization
-Baseline](10-produck-node.instructions.md).
+Baseline](10-produck-node.instructions.md) and [Test Authoring
+Baseline](12-produck-test.instructions.md).

package/publish-assets/instructions/produck/10-produck-node.instructions.md

@@ -29,8 +29,9 @@ Notes:
 
 - Script key names are fixed and must match exactly.
 - Keep the script key name `produck:install` (organization-reserved key).
-- Required root script value for `produck:install` is:
-  `npm -v && npm install`
+- The required value for `produck:install` is governed by
+  `agent-toolkit sync-install`; see the Monorepo mode section below for the
+  canonical value.
 - `publish` may be a no-op when repository-specific release workflow does not
   use npm publishing.
 - Coverage governance policy:
@@ -115,67 +116,30 @@ Central toolkit command role model:
   interpreter workflows for parsing/filtering over brittle OS-shell pipelines.
 - For human engineers, `run-capture` and `summarize-log` are optional helpers.
 
-Test authoring baseline (required):
+Test authoring baseline:
 
-- MUST use Node.js standard library test runner (`node:test`) with `describe`
-  and `it`.
-- Execution MUST follow the **Single Entrypoint Rule**: always run tests via a
-  dedicated entrypoint (for example `test/index.mjs`) instead of targeting
-  individual files.
-- Command-line execution MUST NOT use the `--test` flag. Use
-  `node <entrypoint>` directly.
-- Each test case must be independently executable.
-- Test cases must not depend on execution order or state from other cases.
-- New test debugging should use local `only` mode for scoped regression.
-- After debugging, remove all `only` markers before final validation.
-
-Recommended local debug flow:
-
-1. Add `{ only: true }` to the target `describe/it` and all ancestor
-   `describe` blocks.
-2. Run `node --test-only test/index.mjs`.
-3. Remove all `only` markers.
-4. Run full regression via repository standard test command.
+- See [Test Authoring Baseline](12-produck-test.instructions.md) for the full
+  test writing, structure, debug, and coverage workflow rules.
 
 Script and output directory policy:
 
-- Reusable project scripts should be committed under root `scripts/`.
-- Organization-level shared tooling may use a central npm package bridge instead
-  of repository-local `scripts/` duplication.
-- Runtime command outputs should be written under root `logs/` (or a documented
-  equivalent) and ignored by git.
-- Temporary debug scripts should not be committed.
-- `.github/` should not be used as a temporary script workspace.
+- Follow script/output placement and lifecycle policy from
+  `00-produck-base.instructions.md`.
+- For monorepo shared configuration and root workspace practices, follow
+  `15-produck-workspace.instructions.md`.
 
 Required ignore baseline:
 
 - Each Node.js repository must include a root `.gitignore`.
-- The root `.gitignore` must start from the GitHub default template for Node.js
-  projects (`Node.gitignore` from github/gitignore).
-- Team-specific ignore conventions should be appended on top of that baseline
-  template, not used as a replacement.
-- The root `.gitignore` should at minimum ignore:
-  - `node_modules/`
-  - `coverage/`
-  - `.env`
-  - `.env.*`
-  - npm logs (for example `npm-debug.log*`)
-  - OS/editor noise (for example `.DS_Store`, `Thumbs.db`, `.vscode/` when
-    workspace settings are not intended to be shared)
+- Baseline template and required minimum entries follow
+  `00-produck-base.instructions.md`.
+- Monorepo centralization policy and workspace-specific ignore guidance follow
+  `15-produck-workspace.instructions.md`.
 
 Team conventions for `.gitignore`:
 
-- Keep organization-wide additions grouped under a dedicated comment block for
-  easy updates.
-- Do not remove baseline entries from the GitHub template unless repository
-  owners document a justified exception.
-- Organization-approved team extension entries are:
-  - `*.ign*` (manually created local directories/files that should not be
-    committed)
-  - `*.gen*` (generated artifacts created by program execution, for example
-    during tests)
-- Append these team entries under a dedicated team block at the end of the root
-  `.gitignore`.
+- Team extension entries and placement rules follow
+  `00-produck-base.instructions.md`.
 
 ## Monorepo mode
 

package/publish-assets/instructions/produck/12-produck-test.instructions.md

@@ -0,0 +1,94 @@
+---
+applyTo: '**'
+---
+
+<!-- managed-by: @produck/agent-toolkit -->
+<!-- source: .github/distribution/produck/12-produck-test.instructions.md -->
+
+# Test Authoring Baseline
+
+## Scope
+
+- Applies to Node.js repositories in the organization.
+- This document governs how tests are authored, structured, and executed.
+- Repository-specific rules may add stricter requirements; they override this
+  baseline when they conflict.
+
+## Framework
+
+- MUST use Node.js standard library test runner (`node:test`) with `describe`
+  and `it`.
+- Do not introduce a third-party test framework unless repository owners
+  explicitly document the justification.
+
+## File structure
+
+- Each package must have a dedicated test directory: `test/`.
+- Tests are organized in individual files per subject area under `test/`.
+- Each package MUST provide a single entrypoint file: `test/index.mjs`.
+- The entrypoint imports all test files to be executed.
+
+Example entrypoint:
+
+```js
+import './feature-a.test.mjs';
+import './feature-b.test.mjs';
+```
+
+## Single Entrypoint Rule (required)
+
+- Execution MUST always go through the entrypoint file.
+- Command-line execution MUST NOT use the `--test` flag. Use
+  `node <entrypoint>` directly.
+- Correct: `node test/index.mjs`
+- Wrong: `node --test` or `node --test test/feature-a.test.mjs`
+- All tooling (scripts, CI, coverage) must target the entrypoint only.
+
+## Test case rules
+
+- Each test case must be independently executable.
+- Test cases must not depend on execution order or shared mutable state from
+  other cases.
+- Avoid global side effects that persist across test cases.
+- Clean up resources (temp files, open handles) at the end of each test case.
+
+## Naming conventions
+
+- Test files use the `.test.mjs` suffix.
+- Top-level `describe` label should match the subject being tested (for example
+  the module name or command name).
+- `it` labels should describe the expected behavior in plain language.
+
+## Local debug workflow (recommended)
+
+When debugging a failing test case:
+
+1. Add `{ only: true }` to the target `it` and all ancestor `describe` blocks.
+2. Run `node --test-only test/index.mjs`.
+3. Verify the issue is isolated.
+4. Remove all `only` markers.
+5. Run full regression: `node test/index.mjs`.
+
+Rules for `only` mode:
+
+- `--test-name-pattern` does NOT match tests nested inside `describe()` blocks
+  — it may silently run zero tests. Do not use it for focused runs.
+- Always remove `only` markers before committing.
+- Never commit a test file with `{ only: true }` present.
+
+## Coverage
+
+- Coverage is governed by `produck:coverage` script and `c8`.
+- Scoped coverage (for partial branch verification during development):
+  `npm exec -- c8 --reporter=lcov --reporter=html --reporter=text-summary node --test-only test/index.mjs`
+- Before merge or release, run full coverage via `npm run produck:coverage`.
+- See [Node.js Baseline](10-produck-node.instructions.md) for coverage script
+  governance details.
+
+## Regression discipline
+
+- Before merge or release: restore executable test commands and fix all failing
+  tests.
+- Temporary non-executable state or failing tests are allowed for intermediate
+  commits.
+- Full regression MUST pass before a release commit is made.

package/publish-assets/instructions/produck/15-produck-workspace.instructions.md

@@ -11,13 +11,6 @@ applyTo: '**'
 
 The Produck monorepo provides unified configuration across all packages for consistency and ease of maintenance.
 
-## Distribution classification
-
-This document is maintained directly as a downstream-distributable source.
-
-- Authoritative path:
-  `.github/distribution/produck/15-produck-workspace.instructions.md`
-
 ## Shared Configurations
 
 ### 1. ESLint Configuration (`eslint.config.mjs`)
@@ -152,38 +145,15 @@ npm run produck:coverage
 
 ### Release & Coverage Tooling
 
-- Monorepo release workflow is `lerna`-based and required.
-- Source of truth for `lerna`/`c8` versions and coverage script template:
+- Release and coverage governance follows
+  `10-produck-node.instructions.md`.
+- Source of truth for version pinning and script templates remains
   `.github/distribution/produck/tooling-version-baseline.json`.
-- `lerna` execution version is governed at organization level, not per
-  repository.
-- Required execution baseline: version specified in `tooling-version-baseline.json`.
-- Required `lerna` invocation:
-  `npm exec -- lerna <subcommand>`.
-- Shared scripts/CI must not use unversioned `npx lerna` or `lerna@latest`.
-- Wrapper scripts are allowed, but should keep parity with organization version
-  policy.
-- Workspace subpackage coverage scripts are fully organization-governed.
-- Deploy/repair coverage scripts via central remediation command:
-  `npm exec -- agent-toolkit sync-coverage --cwd .`.
-- Root anti-drift local hook baseline is organization-governed.
-- Deploy/repair root local hooks via central remediation command:
-  `npm exec -- agent-toolkit sync-git --cwd .`.
-- Deployed coverage scripts use the `c8` version specified in
-  `tooling-version-baseline.json` for each governed workspace package.
-- Deployed local hook baseline uses the `husky` version specified in
-  `tooling-version-baseline.json` for root `devDependencies.husky`.
-- Deployed local hook baseline also pins root
-  `devDependencies.@produck/agent-toolkit` to the fixed version managed by the organization baseline.
-- Shared scripts/CI must not use unversioned `npx c8` or `c8@latest`.
-- `test` script implementation remains repository-defined and is not overwritten
-  by coverage remediation.
-- Root `devDependencies.c8` is pinned at root by `agent-toolkit sync-git`;
-  workspace package `devDependencies.c8` is pinned per package by
-  `agent-toolkit sync-coverage`.
-- Root local hooks may be bypassed intentionally by developers (for example via
-  `--no-verify`) and are treated as local strong guardrails rather than
-  immutable release gates.
+- For monorepo remediation, use:
+  - `npm exec -- agent-toolkit sync-coverage --cwd .`
+  - `npm exec -- agent-toolkit sync-git --cwd .`
+- Keep workspace wrappers and local scripts consistent with Node baseline
+  execution policy.
 
 ## Package Integration
 

package/publish-assets/instructions/produck/tooling-version-baseline.json

@@ -21,10 +21,15 @@
       "version": "3.8.3",
       "policy": "pinned",
       "allowLatest": false
+    },
+    "@produck/eslint-rules": {
+      "version": "0.3.5",
+      "policy": "pinned",
+      "allowLatest": false
     }
   },
   "coverage": {
-    "scriptTemplate": "c8@{c8.version} --reporter=lcov --reporter=html --reporter=text-summary npm test"
+    "scriptTemplate": "c8 --reporter=lcov --reporter=html --reporter=text-summary npm test"
   },
   "enforce": {
     "sharedScriptsDisallow": [

package/publish-assets/prettierignore

@@ -0,0 +1,2 @@
+CHANGELOG.md
+package-lock.json