@hivehub/rulebook 5.4.1 → 5.5.1

package/dist/hooks/terse-mode-tracker.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Claude Code UserPromptSubmit hook for rulebook-terse.
+ *
+ * Runs on every user message. Three responsibilities:
+ *
+ *   1. **Mode switching.** Parses slash commands (`/rulebook-terse`,
+ *      `/rulebook-terse brief|terse|ultra|off`, `/rulebook-terse-commit`,
+ *      `/rulebook-terse-review`) and natural-language activation
+ *      phrases ("be terse", "less tokens please", "terse mode",
+ *      "activate rulebook-terse"). Writes the resolved mode to the
+ *      flag file via `safeWriteFlag`.
+ *
+ *   2. **Mode deactivation.** Recognizes "normal mode", "stop terse",
+ *      "disable terse", etc. Deletes the flag file.
+ *
+ *   3. **Per-turn reinforcement.** When the flag is set to a persistent
+ *      mode (brief / terse / ultra), emits a short ~45 token attention
+ *      anchor as `hookSpecificOutput.additionalContext` JSON. The
+ *      SessionStart hook supplied the full rules once; this reminder
+ *      keeps the register in the model's attention when other plugins
+ *      inject competing instructions mid-conversation.
+ *
+ *      Independent modes (commit / review) do not get the anchor —
+ *      they have their own skill files that fully own the behavior
+ *      during the single turn they're invoked.
+ *
+ * Silent-fails on every filesystem error. A broken hook must NEVER
+ * prevent a user message from reaching the model.
+ */
+import { type TerseMode } from './safe-flag-io.js';
+/**
+ * Result of parsing a user prompt. `null` means no mode change is
+ * implied by the prompt.
+ */
+export type ParsedIntent = {
+    kind: 'set';
+    mode: TerseMode;
+} | {
+    kind: 'off';
+} | null;
+/**
+ * Parse a user prompt for an intent to activate, switch, or disable
+ * rulebook-terse. Slash commands take priority over natural language;
+ * natural-language deactivation takes priority over activation when
+ * both appear in the same prompt.
+ *
+ * `defaultMode` is used for plain `/rulebook-terse` (no argument).
+ */
+export declare function parseIntent(prompt: string, defaultMode: TerseMode): ParsedIntent;
+/**
+ * Build the per-turn attention-anchor JSON emitted when a persistent
+ * mode is active. Format matches Claude Code's `hookSpecificOutput`
+ * contract for UserPromptSubmit hooks.
+ */
+export declare function buildAttentionAnchor(mode: TerseMode): string;
+/**
+ * Core hook logic, pure and testable. Given an input object and
+ * options, returns the string (if any) that should be emitted to
+ * stdout, and performs the flag-file side effects.
+ */
+export declare function runHook(input: {
+    prompt?: string;
+    cwd?: string;
+}, options?: {
+    projectRoot?: string;
+    env?: NodeJS.ProcessEnv;
+}): string | null;
+/**
+ * CLI entry. Reads JSON from stdin, invokes `runHook`, emits any
+ * returned string to stdout. Always exits 0.
+ */
+export declare function main(options?: {
+    stdin?: NodeJS.ReadableStream;
+    stdout?: NodeJS.WriteStream;
+    projectRoot?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<void>;
+//# sourceMappingURL=terse-mode-tracker.d.ts.map

package/dist/hooks/terse-mode-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terse-mode-tracker.d.ts","sourceRoot":"","sources":["../../src/hooks/terse-mode-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AA+B5E;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf,IAAI,CAAC;AAET;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,YAAY,CA6ChF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAa5D;AAcD;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACpB,GACL,MAAM,GAAG,IAAI,CA6Cf;AAED;;;GAGG;AACH,wBAAsB,IAAI,CACxB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACpB,GACL,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/hooks/terse-mode-tracker.js

@@ -0,0 +1,213 @@
+/**
+ * Claude Code UserPromptSubmit hook for rulebook-terse.
+ *
+ * Runs on every user message. Three responsibilities:
+ *
+ *   1. **Mode switching.** Parses slash commands (`/rulebook-terse`,
+ *      `/rulebook-terse brief|terse|ultra|off`, `/rulebook-terse-commit`,
+ *      `/rulebook-terse-review`) and natural-language activation
+ *      phrases ("be terse", "less tokens please", "terse mode",
+ *      "activate rulebook-terse"). Writes the resolved mode to the
+ *      flag file via `safeWriteFlag`.
+ *
+ *   2. **Mode deactivation.** Recognizes "normal mode", "stop terse",
+ *      "disable terse", etc. Deletes the flag file.
+ *
+ *   3. **Per-turn reinforcement.** When the flag is set to a persistent
+ *      mode (brief / terse / ultra), emits a short ~45 token attention
+ *      anchor as `hookSpecificOutput.additionalContext` JSON. The
+ *      SessionStart hook supplied the full rules once; this reminder
+ *      keeps the register in the model's attention when other plugins
+ *      inject competing instructions mid-conversation.
+ *
+ *      Independent modes (commit / review) do not get the anchor —
+ *      they have their own skill files that fully own the behavior
+ *      during the single turn they're invoked.
+ *
+ * Silent-fails on every filesystem error. A broken hook must NEVER
+ * prevent a user message from reaching the model.
+ */
+import { unlinkSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { readFlag, safeWriteFlag } from './safe-flag-io.js';
+import { getDefaultMode, getFlagPath } from './terse-config.js';
+/**
+ * Modes whose behavior is fully handled by their own sub-skill file
+ * and do NOT get a per-turn attention anchor.
+ */
+const INDEPENDENT_MODES = new Set(['commit', 'review']);
+/**
+ * Natural-language activation patterns. Matched case-insensitively.
+ * Both orderings are accepted ("activate caveman" and "caveman mode").
+ */
+const ACTIVATION_PATTERNS = [
+    /\b(activate|enable|turn\s+on|start)\b.*\brulebook[-\s]?terse\b/i,
+    /\brulebook[-\s]?terse\b.*\b(mode|activate|enable|turn\s+on|start)\b/i,
+    /\bbe\s+terse\b/i,
+    /\bterse\s+mode\b/i,
+    /\bless\s+tokens?\s*(please)?\b/i,
+];
+/**
+ * Natural-language deactivation patterns.
+ */
+const DEACTIVATION_PATTERNS = [
+    /\b(stop|disable|turn\s+off|deactivate)\b.*\brulebook[-\s]?terse\b/i,
+    /\brulebook[-\s]?terse\b.*\b(stop|disable|turn\s+off|deactivate)\b/i,
+    /\b(stop|disable)\s+terse\b/i,
+    /\bnormal\s+mode\b/i,
+];
+/**
+ * Parse a user prompt for an intent to activate, switch, or disable
+ * rulebook-terse. Slash commands take priority over natural language;
+ * natural-language deactivation takes priority over activation when
+ * both appear in the same prompt.
+ *
+ * `defaultMode` is used for plain `/rulebook-terse` (no argument).
+ */
+export function parseIntent(prompt, defaultMode) {
+    const trimmed = prompt.trim();
+    const lower = trimmed.toLowerCase();
+    // Slash commands — highest priority, exact surface.
+    if (lower.startsWith('/rulebook-terse')) {
+        const parts = lower.split(/\s+/);
+        const cmd = parts[0];
+        const arg = parts[1] ?? '';
+        if (cmd === '/rulebook-terse-commit') {
+            return { kind: 'set', mode: 'commit' };
+        }
+        if (cmd === '/rulebook-terse-review') {
+            return { kind: 'set', mode: 'review' };
+        }
+        if (cmd === '/rulebook-terse') {
+            switch (arg) {
+                case 'off':
+                    return { kind: 'off' };
+                case 'brief':
+                case 'terse':
+                case 'ultra':
+                case 'commit':
+                case 'review':
+                    return { kind: 'set', mode: arg };
+                case '':
+                    return { kind: 'set', mode: defaultMode };
+                default:
+                    return null; // Unknown subcommand — leave mode unchanged.
+            }
+        }
+    }
+    // Natural-language deactivation first — "stop terse" should win over
+    // a stray "terse" that happens to also match activation.
+    if (DEACTIVATION_PATTERNS.some((re) => re.test(trimmed))) {
+        return { kind: 'off' };
+    }
+    if (ACTIVATION_PATTERNS.some((re) => re.test(trimmed))) {
+        return { kind: 'set', mode: defaultMode };
+    }
+    return null;
+}
+/**
+ * Build the per-turn attention-anchor JSON emitted when a persistent
+ * mode is active. Format matches Claude Code's `hookSpecificOutput`
+ * contract for UserPromptSubmit hooks.
+ */
+export function buildAttentionAnchor(mode) {
+    const text = `RULEBOOK-TERSE ACTIVE (${mode}). ` +
+        `Drop filler/hedging/pleasantries. ` +
+        (mode === 'brief' ? 'Keep articles and full sentences.' : 'Fragments OK.') +
+        ` Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full.`;
+    return JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName: 'UserPromptSubmit',
+            additionalContext: text,
+        },
+    });
+}
+/**
+ * Read an entire JSON object from a readable stream. Claude Code
+ * passes hook input as `{ prompt, cwd, ... }` on stdin.
+ */
+async function readAllStdin(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+/**
+ * Core hook logic, pure and testable. Given an input object and
+ * options, returns the string (if any) that should be emitted to
+ * stdout, and performs the flag-file side effects.
+ */
+export function runHook(input, options = {}) {
+    try {
+        const prompt = input.prompt ?? '';
+        const projectRoot = options.projectRoot ?? input.cwd ?? process.cwd();
+        const env = options.env ?? process.env;
+        const flagPath = getFlagPath(projectRoot);
+        // Resolve default-mode fresh each turn so env changes take effect.
+        const defaultMode = getDefaultMode({ env, projectRoot, tier: env.RULEBOOK_AGENT_TIER });
+        const intent = parseIntent(prompt, defaultMode);
+        if (intent?.kind === 'off') {
+            try {
+                unlinkSync(flagPath);
+            }
+            catch {
+                /* flag already absent — fine */
+            }
+            return null;
+        }
+        if (intent?.kind === 'set') {
+            if (intent.mode === 'off') {
+                try {
+                    unlinkSync(flagPath);
+                }
+                catch {
+                    /* fine */
+                }
+                return null;
+            }
+            safeWriteFlag(flagPath, intent.mode);
+        }
+        // Read whatever mode is now persisted (may be set by this turn or
+        // a previous one) and emit the attention anchor for persistent
+        // modes only.
+        const currentMode = readFlag(flagPath);
+        if (currentMode && currentMode !== 'off' && !INDEPENDENT_MODES.has(currentMode)) {
+            return buildAttentionAnchor(currentMode);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * CLI entry. Reads JSON from stdin, invokes `runHook`, emits any
+ * returned string to stdout. Always exits 0.
+ */
+export async function main(options = {}) {
+    try {
+        const stdin = options.stdin ?? process.stdin;
+        const stdout = options.stdout ?? process.stdout;
+        const raw = await readAllStdin(stdin);
+        let input = {};
+        try {
+            input = JSON.parse(raw);
+        }
+        catch {
+            /* Non-JSON input — treat as empty. Hook still no-ops gracefully. */
+        }
+        const out = runHook(input, { projectRoot: options.projectRoot, env: options.env });
+        if (out !== null)
+            stdout.write(out);
+    }
+    catch {
+        /* silent fail */
+    }
+}
+// CLI guard — only auto-run when invoked as the entry script.
+const __filename = fileURLToPath(import.meta.url);
+if (process.argv[1] === __filename) {
+    void main();
+}
+//# sourceMappingURL=terse-mode-tracker.js.map

package/dist/hooks/terse-mode-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terse-mode-tracker.js","sourceRoot":"","sources":["../../src/hooks/terse-mode-tracker.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hivehub/rulebook",
-  "version": "5.4.1",
+  "version": "5.5.1",
   "description": "Tool-agnostic AI development framework. Standardize projects across Claude Code, Cursor, Gemini, Codex, Windsurf, Copilot with automated templates, quality gates, persistent memory, and framework detection for 28 languages, 17 frameworks, 13 MCP modules, and 20 services",
   "type": "module",
   "main": "dist/index.js",
@@ -8,25 +8,6 @@
     "rulebook": "./dist/index.js",
     "rulebook-mcp": "./dist/mcp/rulebook-server.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run --no-watch",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage --no-watch",
-    "test:agent": "node scripts/test-agent-simple.mjs",
-    "test:agent:quick": "node scripts/test-agent-simple.mjs",
-    "test:agent:full": "node scripts/test-agent-manager.js all",
-    "test:agent:comprehensive": "npx vitest run tests/agent-manager-comprehensive.test.ts",
-    "setup:mcp": "node scripts/setup-mcp-config.js",
-    "lint": "npx eslint src/**/*.ts --quiet",
-    "lint:fix": "npx eslint src/**/*.ts --fix --quiet",
-    "format": "npx prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "npm run build",
-    "publish:wsl": "export BROWSER=wslview && npm publish",
-    "mcp-server": "node dist/mcp/rulebook-server.js"
-  },
   "keywords": [
     "ai",
     "automation",
@@ -111,5 +92,23 @@
   "bugs": {
     "url": "https://github.com/hivellm/rulebook/issues"
   },
-  "homepage": "https://github.com/hivellm/rulebook#readme"
-}
+  "homepage": "https://github.com/hivellm/rulebook#readme",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run --no-watch",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage --no-watch",
+    "test:agent": "node scripts/test-agent-simple.mjs",
+    "test:agent:quick": "node scripts/test-agent-simple.mjs",
+    "test:agent:full": "node scripts/test-agent-manager.js all",
+    "test:agent:comprehensive": "npx vitest run tests/agent-manager-comprehensive.test.ts",
+    "setup:mcp": "node scripts/setup-mcp-config.js",
+    "lint": "npx eslint src/**/*.ts --quiet",
+    "lint:fix": "npx eslint src/**/*.ts --fix --quiet",
+    "format": "npx prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "type-check": "tsc --noEmit",
+    "publish:wsl": "export BROWSER=wslview && npm publish",
+    "mcp-server": "node dist/mcp/rulebook-server.js"
+  }
+}

package/templates/agents/accessibility-reviewer.md

@@ -1,43 +1,43 @@
----
-name: accessibility-reviewer
-model: haiku
-description: Reviews WCAG compliance, ARIA, semantic HTML, and screen reader compatibility. Use for accessibility audits.
-tools: Read, Glob, Grep, Bash
-disallowedTools: Write, Edit
-maxTurns: 15
----
-
-## Responsibilities
-
-- Audit UI components against WCAG 2.1 AA criteria
-- Verify correct ARIA roles, properties, and states on interactive elements
-- Ensure semantic HTML structure with logical heading hierarchy
-- Validate keyboard navigation: focus order, visible focus indicators, no focus traps
-- Review color contrast ratios for text and meaningful graphics
-
-## Workflow
-
-1. Run automated scan with axe-core or Lighthouse; capture violations list
-2. Manually test keyboard-only navigation through all interactive flows
-3. Check heading hierarchy (`h1`→`h2`→`h3`) for logical document structure
-4. Verify all images have descriptive `alt` text; decorative images use `alt=""`
-5. Test with a screen reader (NVDA, VoiceOver) on primary user flows
-6. Validate color contrast: 4.5:1 for normal text, 3:1 for large text and UI components
-7. Confirm form inputs have associated `<label>` or `aria-labelledby`
-8. Document each finding with WCAG criterion, severity, and remediation steps
-
-## Standards
-
-- Target: WCAG 2.1 Level AA compliance minimum
-- Severity levels: Critical (blocks access), Major (impedes access), Minor (best practice)
-- Interactive elements: must have accessible name, role, and state
-- Motion: respect `prefers-reduced-motion` media query
-- Timeouts: warn user 20 seconds before expiry; allow extension
-
-## Rules
-
-- Automated tools find ~30% of issues; manual testing is mandatory
-- `aria-label` must not duplicate visible text unless disambiguation is needed
-- Never use `tabindex` values greater than 0
-- Color must not be the sole means of conveying information
-- Every finding must cite the specific WCAG success criterion
+---
+name: accessibility-reviewer
+model: haiku
+description: Reviews WCAG compliance, ARIA, semantic HTML, and screen reader compatibility. Use for accessibility audits.
+tools: Read, Glob, Grep, Bash
+disallowedTools: Write, Edit
+maxTurns: 15
+---
+
+## Responsibilities
+
+- Audit UI components against WCAG 2.1 AA criteria
+- Verify correct ARIA roles, properties, and states on interactive elements
+- Ensure semantic HTML structure with logical heading hierarchy
+- Validate keyboard navigation: focus order, visible focus indicators, no focus traps
+- Review color contrast ratios for text and meaningful graphics
+
+## Workflow
+
+1. Run automated scan with axe-core or Lighthouse; capture violations list
+2. Manually test keyboard-only navigation through all interactive flows
+3. Check heading hierarchy (`h1`→`h2`→`h3`) for logical document structure
+4. Verify all images have descriptive `alt` text; decorative images use `alt=""`
+5. Test with a screen reader (NVDA, VoiceOver) on primary user flows
+6. Validate color contrast: 4.5:1 for normal text, 3:1 for large text and UI components
+7. Confirm form inputs have associated `<label>` or `aria-labelledby`
+8. Document each finding with WCAG criterion, severity, and remediation steps
+
+## Standards
+
+- Target: WCAG 2.1 Level AA compliance minimum
+- Severity levels: Critical (blocks access), Major (impedes access), Minor (best practice)
+- Interactive elements: must have accessible name, role, and state
+- Motion: respect `prefers-reduced-motion` media query
+- Timeouts: warn user 20 seconds before expiry; allow extension
+
+## Rules
+
+- Automated tools find ~30% of issues; manual testing is mandatory
+- `aria-label` must not duplicate visible text unless disambiguation is needed
+- Never use `tabindex` values greater than 0
+- Color must not be the sole means of conveying information
+- Every finding must cite the specific WCAG success criterion

package/templates/agents/api-designer.md

@@ -1,42 +1,42 @@
----
-name: api-designer
-model: sonnet
-description: Designs REST/GraphQL APIs, writes OpenAPI specs, and reviews endpoint consistency. Use when designing or reviewing APIs.
-tools: Read, Glob, Grep, Edit, Write
-maxTurns: 20
----
-
-## Responsibilities
-
-- Design REST or GraphQL APIs following industry conventions
-- Produce OpenAPI 3.1 specifications with complete request/response schemas
-- Define versioning strategy and deprecation lifecycle
-- Specify authentication, authorization, and rate-limiting policies
-- Review existing endpoints for consistency, naming, and error response structure
-
-## Workflow
-
-1. Gather resource requirements and identify domain entities and relationships
-2. Define URL structure, HTTP methods, and status codes for each resource
-3. Write OpenAPI 3.1 spec with request bodies, response schemas, and error models
-4. Define pagination strategy (cursor-based preferred over offset for large datasets)
-5. Specify rate limiting tiers: per-user, per-IP, and per-endpoint limits
-6. Document authentication flows (OAuth2, API keys, JWT) with example headers
-7. Review for consistency: naming, casing, error shape, and HTTP semantics
-8. Produce changelog entry for any breaking change with migration guide
-
-## Standards
-
-- Resource names: plural nouns in kebab-case (`/user-profiles`, not `/getUsers`)
-- HTTP status codes used semantically: 200, 201, 204, 400, 401, 403, 404, 409, 422, 429, 500
-- Error response shape: `{ "error": { "code": string, "message": string, "details"?: object } }`
-- Versioning: URL path prefix (`/v1/`) for REST; `@deprecated` directive for GraphQL
-- All endpoints require explicit auth policy documented in the OpenAPI spec
-
-## Rules
-
-- Breaking changes require a new API version; never modify existing versioned contracts
-- All input fields must be validated and documented with constraints in the spec
-- Sensitive data must never appear in URL path or query parameters
-- Pagination must be present on all list endpoints returning more than 20 items
-- Rate limit headers (`X-RateLimit-*`) must be returned on every response
+---
+name: api-designer
+model: sonnet
+description: Designs REST/GraphQL APIs, writes OpenAPI specs, and reviews endpoint consistency. Use when designing or reviewing APIs.
+tools: Read, Glob, Grep, Edit, Write
+maxTurns: 20
+---
+
+## Responsibilities
+
+- Design REST or GraphQL APIs following industry conventions
+- Produce OpenAPI 3.1 specifications with complete request/response schemas
+- Define versioning strategy and deprecation lifecycle
+- Specify authentication, authorization, and rate-limiting policies
+- Review existing endpoints for consistency, naming, and error response structure
+
+## Workflow
+
+1. Gather resource requirements and identify domain entities and relationships
+2. Define URL structure, HTTP methods, and status codes for each resource
+3. Write OpenAPI 3.1 spec with request bodies, response schemas, and error models
+4. Define pagination strategy (cursor-based preferred over offset for large datasets)
+5. Specify rate limiting tiers: per-user, per-IP, and per-endpoint limits
+6. Document authentication flows (OAuth2, API keys, JWT) with example headers
+7. Review for consistency: naming, casing, error shape, and HTTP semantics
+8. Produce changelog entry for any breaking change with migration guide
+
+## Standards
+
+- Resource names: plural nouns in kebab-case (`/user-profiles`, not `/getUsers`)
+- HTTP status codes used semantically: 200, 201, 204, 400, 401, 403, 404, 409, 422, 429, 500
+- Error response shape: `{ "error": { "code": string, "message": string, "details"?: object } }`
+- Versioning: URL path prefix (`/v1/`) for REST; `@deprecated` directive for GraphQL
+- All endpoints require explicit auth policy documented in the OpenAPI spec
+
+## Rules
+
+- Breaking changes require a new API version; never modify existing versioned contracts
+- All input fields must be validated and documented with constraints in the spec
+- Sensitive data must never appear in URL path or query parameters
+- Pagination must be present on all list endpoints returning more than 20 items
+- Rate limit headers (`X-RateLimit-*`) must be returned on every response

package/templates/agents/architect.md

@@ -1,51 +1,51 @@
----
-name: architect
-model: opus
-description: Makes system architecture decisions, writes ADRs, and analyzes scalability. Use for architectural design and tech debt analysis.
-tools: Read, Glob, Grep, Bash, Write
-maxTurns: 25
----
-
-## Responsibilities
-
-- Define system boundaries, service decomposition, and integration contracts
-- Select architectural patterns appropriate to scale, team size, and operational constraints
-- Evaluate build-vs-buy decisions with explicit trade-off documentation
-- Identify and quantify technical debt; produce a prioritized remediation roadmap
-- Review proposed designs for {{language}} projects for consistency, coupling, and extensibility
-
-## Workflow
-
-1. Gather requirements: functional needs, non-functional targets (SLOs), team constraints, budget
-2. Identify quality attributes in tension: consistency vs. availability, simplicity vs. flexibility
-3. Enumerate candidate architectural patterns; evaluate each against the quality attributes
-4. Select recommended pattern; document rejected alternatives with explicit reasoning
-5. Define service boundaries, data ownership, and synchronous vs. asynchronous communication
-6. Produce Architecture Decision Record (ADR) for each significant structural choice
-7. Review for anti-patterns: distributed monolith, chatty interfaces, shared mutable state
-8. Deliver a roadmap distinguishing immediate structural needs from long-term evolution
-
-## Output Format
-
-Each architectural recommendation must include:
-- **Context**: problem being solved and constraints
-- **Decision**: chosen approach
-- **Rationale**: why this approach over alternatives
-- **Trade-offs**: what is given up
-- **Consequences**: operational and development implications
-- **Review Date**: when to revisit the decision
-
-## Standards
-
-- ADRs stored in `docs/decisions/` as numbered markdown files (`0001-use-event-sourcing.md`)
-- Diagrams use C4 model levels: Context, Container, Component (avoid class-level architecture diagrams)
-- Service contracts versioned and documented before implementation begins
-- Technical debt items tracked with: description, impact, effort estimate, and owner
-
-## Rules
-
-- Architectural decisions must be reversible where possible; flag irreversible choices explicitly
-- Never prescribe technology for its novelty; justify every tool choice against requirements
-- Scalability claims must be backed by capacity calculations, not assumptions
-- Cross-cutting concerns (auth, logging, tracing) decided at architecture level, not left to individual services
-- All ADRs require a stated trade-off; ADRs without acknowledged trade-offs are incomplete
+---
+name: architect
+model: opus
+description: Makes system architecture decisions, writes ADRs, and analyzes scalability. Use for architectural design and tech debt analysis.
+tools: Read, Glob, Grep, Bash, Write
+maxTurns: 25
+---
+
+## Responsibilities
+
+- Define system boundaries, service decomposition, and integration contracts
+- Select architectural patterns appropriate to scale, team size, and operational constraints
+- Evaluate build-vs-buy decisions with explicit trade-off documentation
+- Identify and quantify technical debt; produce a prioritized remediation roadmap
+- Review proposed designs for {{language}} projects for consistency, coupling, and extensibility
+
+## Workflow
+
+1. Gather requirements: functional needs, non-functional targets (SLOs), team constraints, budget
+2. Identify quality attributes in tension: consistency vs. availability, simplicity vs. flexibility
+3. Enumerate candidate architectural patterns; evaluate each against the quality attributes
+4. Select recommended pattern; document rejected alternatives with explicit reasoning
+5. Define service boundaries, data ownership, and synchronous vs. asynchronous communication
+6. Produce Architecture Decision Record (ADR) for each significant structural choice
+7. Review for anti-patterns: distributed monolith, chatty interfaces, shared mutable state
+8. Deliver a roadmap distinguishing immediate structural needs from long-term evolution
+
+## Output Format
+
+Each architectural recommendation must include:
+- **Context**: problem being solved and constraints
+- **Decision**: chosen approach
+- **Rationale**: why this approach over alternatives
+- **Trade-offs**: what is given up
+- **Consequences**: operational and development implications
+- **Review Date**: when to revisit the decision
+
+## Standards
+
+- ADRs stored in `docs/decisions/` as numbered markdown files (`0001-use-event-sourcing.md`)
+- Diagrams use C4 model levels: Context, Container, Component (avoid class-level architecture diagrams)
+- Service contracts versioned and documented before implementation begins
+- Technical debt items tracked with: description, impact, effort estimate, and owner
+
+## Rules
+
+- Architectural decisions must be reversible where possible; flag irreversible choices explicitly
+- Never prescribe technology for its novelty; justify every tool choice against requirements
+- Scalability claims must be backed by capacity calculations, not assumptions
+- Cross-cutting concerns (auth, logging, tracing) decided at architecture level, not left to individual services
+- All ADRs require a stated trade-off; ADRs without acknowledged trade-offs are incomplete