mandrel 1.72.0 → 1.74.0

package/.agents/scripts/providers/github/project-board.js

@@ -2,11 +2,11 @@
  * GitHub Provider — ProjectBoardGateway.
  *
  * Owns the Projects V2 bootstrap surface: `resolveOrCreateProject`,
- * `ensureStatusField`, `ensureProjectViews`, `ensureProjectFields`. The
- * low-level GraphQL mutations live in `./projects-v2-graphql.js`; this
- * class threads the parent provider's `_ctx` (which carries `projectNumber`,
- * `projectOwner`, `state`, and the shared cache) into each call so the
- * legacy shim contract is preserved.
+ * `ensureStatusField`, `ensureProjectFields`. The low-level GraphQL
+ * mutations live in `./projects-v2-graphql.js`; this class threads the
+ * parent provider's `_ctx` (which carries `projectNumber`, `projectOwner`,
+ * `state`, and the shared cache) into each call so the legacy shim contract
+ * is preserved.
  *
  * Extracted from `../github.js` in Story #2462 / Task #2479. Public
  * surface on `GitHubProvider` is unchanged — every project-board method
@@ -36,10 +36,6 @@ export class ProjectBoardGateway {
     return projects.ensureStatusField(this._ctx, optionNames);
   }
 
-  async ensureProjectViews(viewDefs) {
-    return projects.ensureProjectViews(this._ctx, viewDefs);
-  }
-
   /* node:coverage ignore next */
   async ensureProjectFields(fieldDefs) {
     return projects.ensureProjectFields(this._ctx, fieldDefs);

package/.agents/scripts/providers/github/projects-v2-graphql.js

@@ -21,14 +21,8 @@ const Q_PROJ = (scope, fields) =>
 const M_PROJ = `mutation($ownerId:ID!,$title:String!){createProjectV2(input:{ownerId:$ownerId,title:$title}){projectV2{id number}}}`;
 const M_FIELD = `mutation($projectId:ID!,$name:String!,$options:[ProjectV2SingleSelectFieldOptionInput!]!){createProjectV2Field(input:{projectId:$projectId,dataType:SINGLE_SELECT,name:$name,singleSelectOptions:$options}){projectV2Field{... on ProjectV2SingleSelectField{id name}}}}`;
 const M_UPDATE = `mutation($fieldId:ID!,$name:String!,$options:[ProjectV2SingleSelectFieldOptionInput!]!){updateProjectV2Field(input:{fieldId:$fieldId,name:$name,singleSelectOptions:$options}){projectV2Field{... on ProjectV2SingleSelectField{id name}}}}`;
-// Projects V2 view creation uses the REST API — the GraphQL
-// `createProjectV2View` mutation is not generally available. Endpoints:
-//   org-owned:  POST /orgs/{org}/projectsV2/{number}/views        ({org} login)
-//   user-owned: POST /users/{user_id}/projectsV2/{number}/views   (numeric id)
-const REST_API_VERSION = '2026-03-10';
 const M_ITEM = `mutation($projectId:ID!,$contentId:ID!){addProjectV2ItemById(input:{projectId:$projectId,contentId:$contentId}){item{id}}}`;
 const F_STATUS = `id fields(first:50){nodes{... on ProjectV2SingleSelectField{id name options{id name}}}}`;
-const F_VIEWS = `id views(first:50){nodes{name}}`;
 const F_FIELDS = `id fields(first:50){nodes{... on ProjectV2Field{name} ... on ProjectV2IterationField{name} ... on ProjectV2SingleSelectField{name}}}`;
 const SCOPES_RE =
   /INSUFFICIENT_SCOPES|Resource not accessible by personal access token|your token has not been granted the required scopes/i;
@@ -106,97 +100,6 @@ async function gql(ctx, query, variables, { retry = false } = {}) {
   return retry ? withTransientRetry(run) : run();
 }
 
-/**
- * Issue a REST request against api.github.com, reusing the same token and
- * fetch seam as `gql`. Throws on non-2xx with the response body for context.
- * Pass `{ retry: true }` to retry transient network blips (idempotent calls).
- */
-async function rest(ctx, method, apiPath, body, { retry = false } = {}) {
-  const run = async () => {
-    const fetchImpl = ctx.fetchImpl ?? globalThis.fetch;
-    const response = await fetchImpl(`https://api.github.com${apiPath}`, {
-      method,
-      headers: {
-        Accept: 'application/vnd.github+json',
-        Authorization: `Bearer ${ctx.token ?? resolveToken()}`,
-        'Content-Type': 'application/json',
-        'User-Agent': 'node.js',
-        'X-GitHub-Api-Version': REST_API_VERSION,
-      },
-      ...(body ? { body: JSON.stringify(body) } : {}),
-    });
-    if (!response.ok) {
-      const text = await response.text().catch(() => '');
-      const err = new Error(
-        `[GitHubProvider] REST ${method} ${apiPath} → ${response.status}: ${text}`,
-      );
-      err.status = response.status;
-      throw err;
-    }
-    return response.json().catch(() => ({}));
-  };
-  return retry ? withTransientRetry(run) : run();
-}
-
-/**
- * Resolve an owner login to its account type and numeric id via
- * `GET /users/{login}` (which serves both users and orgs). The REST views
- * endpoint keys orgs by login but users by numeric id, so we need both.
- */
-async function resolveOwnerAccount(ctx, owner) {
-  const data = await rest(
-    ctx,
-    'GET',
-    `/users/${encodeURIComponent(owner)}`,
-    undefined,
-    { retry: true },
-  );
-  return { id: data?.id ?? null, type: data?.type ?? null };
-}
-
-/**
- * Build the candidate REST views endpoints to try, in order. Orgs key by
- * login. For user-owned projects the docs label the path param `{user_id}`
- * but it's ambiguous (numeric id vs login) and the numeric form was observed
- * to 404 — so we try the login first (mirroring the org endpoint) then fall
- * back to the numeric id, treating a 404 as "wrong param, try the next".
- */
-function viewsEndpoints(account, owner, projectNumber) {
-  if (account.type === 'Organization') {
-    return [
-      `/orgs/${encodeURIComponent(owner)}/projectsV2/${projectNumber}/views`,
-    ];
-  }
-  const candidates = [];
-  if (owner) {
-    candidates.push(
-      `/users/${encodeURIComponent(owner)}/projectsV2/${projectNumber}/views`,
-    );
-  }
-  if (account.id != null) {
-    candidates.push(`/users/${account.id}/projectsV2/${projectNumber}/views`);
-  }
-  return candidates;
-}
-
-/**
- * POST a view to the first candidate endpoint that does not 404. A 404 means
- * the path param shape was wrong (login vs numeric id) — try the next. Any
- * other status is a real failure and propagates.
- */
-async function createView(ctx, endpoints, body) {
-  let lastError = null;
-  for (const endpoint of endpoints) {
-    try {
-      return await rest(ctx, 'POST', endpoint, body, { retry: true });
-    } catch (err) {
-      lastError = err;
-      if (err.status !== 404) throw err;
-    }
-  }
-  throw lastError ?? new Error('[GitHubProvider] No views endpoint available.');
-}
-
 async function lookupProject(ctx, fragment, strict = false) {
   if (!ctx.projectNumber) return null;
   let lastError = null;
@@ -357,75 +260,6 @@ export async function ensureStatusField(ctx, optionNames) {
   }
 }
 
-export async function ensureProjectViews(ctx, viewDefs) {
-  if (!ctx.projectNumber)
-    throw new Error(
-      '[GitHubProvider] ensureProjectViews requires projectNumber.',
-    );
-  const created = [],
-    skipped = [];
-  let project;
-  try {
-    project = await lookupProject(ctx, F_VIEWS, true);
-  } catch {
-    return {
-      created,
-      skipped: viewDefs.map((view) => view.name),
-      unavailable: true,
-    };
-  }
-  if (!project)
-    throw new Error(
-      `[GitHubProvider] Project #${ctx.projectNumber} not found for ${ctx.projectOwner}.`,
-    );
-  const existingViewNames = new Set(
-    (project.views?.nodes ?? []).map((view) => view?.name).filter(Boolean),
-  );
-
-  // Resolve the owner account once to pick the right REST endpoint shape.
-  let account;
-  try {
-    account = await resolveOwnerAccount(ctx, ctx.projectOwner);
-  } catch (err) {
-    return {
-      created,
-      skipped: viewDefs.map((view) => view.name),
-      unavailable: true,
-      error: err.message,
-    };
-  }
-
-  const endpoints = viewsEndpoints(
-    account,
-    ctx.projectOwner,
-    ctx.projectNumber,
-  );
-  let unavailable = false;
-  let error;
-  for (const def of viewDefs) {
-    if (existingViewNames.has(def.name) || unavailable) {
-      skipped.push(def.name);
-      continue;
-    }
-    try {
-      await createView(ctx, endpoints, {
-        name: def.name,
-        // PROJECT_VIEW_DEFS predate REST layouts; the GraphQL path always
-        // created board views, so default to 'board' (override via
-        // `def.layout` = 'table' | 'board' | 'roadmap').
-        layout: def.layout ?? 'board',
-        ...(def.filter ? { filter: def.filter } : {}),
-      });
-      created.push(def.name);
-    } catch (err) {
-      unavailable = true;
-      error = err.message;
-      skipped.push(def.name);
-    }
-  }
-  return { created, skipped, unavailable, ...(error ? { error } : {}) };
-}
-
 export async function ensureProjectFields(ctx, fieldDefs) {
   if (!ctx.projectNumber) return { created: [], skipped: [] };
   const project = await lookupProject(ctx, F_FIELDS);

package/.agents/scripts/providers/github/tickets.js

@@ -23,6 +23,7 @@
 
 import { parseBlockedBy, parseBlocks } from '../../lib/dependency-parser.js';
 import { Logger } from '../../lib/Logger.js';
+import { TYPE_LABELS } from '../../lib/label-constants.js';
 import { addIssueToBoard } from './board-add.js';
 import { createInlineTicketCache } from './cache.js';
 import { withTransientRetry } from './errors.js';
@@ -318,13 +319,21 @@ export class TicketGateway {
       dependencies: ticketData.dependencies ?? [],
     });
 
+    // Mirror the Epic create path (issues.js:160 → `labels: TYPE_LABELS.EPIC`):
+    // always inject TYPE_LABELS.STORY so a spec that omits the labels array
+    // cannot produce an unlabeled, undispatchable Story. Dedupe to avoid
+    // duplicates when the caller already carries the label.
+    const callerLabels = ticketData.labels ?? [];
+    const labels = callerLabels.includes(TYPE_LABELS.STORY)
+      ? callerLabels
+      : [TYPE_LABELS.STORY, ...callerLabels];
     const result = await this._gh.api({
       method: 'POST',
       endpoint: `/repos/${this.owner}/${this.repo}/issues`,
       body: {
         title: ticketData.title,
         body: renderedBody,
-        labels: ticketData.labels ?? [],
+        labels,
       },
     });
     const issue = parseApiJson(result);

package/.agents/scripts/providers/github.js

@@ -130,7 +130,6 @@ const DELEGATIONS = [
   ['setMergeMethods', 'mergeMethods.setMergeMethods'],
   ['resolveOrCreateProject', 'projectBoard.resolveOrCreateProject'],
   ['ensureStatusField', 'projectBoard.ensureStatusField'],
-  ['ensureProjectViews', 'projectBoard.ensureProjectViews'],
   ['ensureProjectFields', 'projectBoard.ensureProjectFields'],
 ];
 for (const [name, target] of DELEGATIONS) {

package/.agents/skills/core/documentation-and-adrs/SKILL.md

@@ -12,7 +12,7 @@ description:
 
 - Document the **why**, not the what. Capture context, constraints, alternatives considered, and trade-offs — code already shows what was built.
 - Write an ADR for any decision that would be expensive to reverse (framework choice, data model, auth strategy, API architecture, hosting platform).
-- Store ADRs at `docs/decisions/` with sequential numbering (`ADR-001`, `ADR-002`, …) and the canonical sections: **Status, Date, Context, Decision, Alternatives Considered, Consequences**.
+- Mandrel ships **two first-class decisions-log layouts** — pick one at onboarding (see [Decisions-log layouts](#decisions-log-layouts)): the **single-file dated-entry** `docs/decisions.md` (default; best for small projects) or the **index + `docs/decisions/` directory** (MADR-style, one file per ADR; best once the log outgrows a single file). Either way, the canonical ADR sections are **Status, Date, Deciders, Context, Decision, (Alternatives Considered), Consequences**.
 - Mark an ADR's status as `Accepted`, `Superseded by ADR-XXX`, or `Deprecated`. Never silently delete an ADR — supersede it.
 - Do **not** document obvious code; do **not** restate what the code already says. Stale or redundant docs are worse than no docs.
 - Comments explain **non-obvious intent** (the why). If a comment describes what the code does, refactor the code instead.
@@ -54,9 +54,41 @@ highest-value documentation you can write.
 - Choosing between build tools, hosting platforms, or infrastructure
 - Any decision that would be expensive to reverse
 
+### Decisions-log layouts
+
+Mandrel ships **two supported layouts** for the decisions log. Both keep the
+mandatory-read file named `docs/decisions.md` (the `project.docsContextFiles`
+default), so `config-resolver.js` and every `.agents/` reference resolve the
+same regardless of which you pick — only the **shape** differs. Choose one at
+onboarding:
+
+| Layout                              | Shape                                                                 | Template(s)                                                                                                | When to use                                                                       |
+| ----------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| **Single-file dated entries** (default) | One `decisions.md` of append-only `## YYYY-MM-DD — title` entries     | [`templates/docs/decisions.md`](../../../templates/docs/decisions.md)                                      | Small projects; a handful of decisions; you want everything in one scannable file. |
+| **Index + `decisions/` directory**  | `decisions.md` is a one-row-per-ADR **index**; each ADR is `decisions/NNNN-*.md` | [`templates/docs/decisions.index.md`](../../../templates/docs/decisions.index.md) + [`templates/docs/decisions/_template.md`](../../../templates/docs/decisions/_template.md) | The log has outgrown a single file (dozens of ADRs); you want per-decision history and `git blame` per ADR. |
+
+To adopt the directory layout, replace `decisions.md` with the index variant,
+create a `decisions/` directory beside it, and scaffold each ADR from
+`decisions/_template.md` using zero-padded sequential numbering
+(`0001-*.md`, `0002-*.md`, …).
+
+> **Loading model (resolved design question).** The decisions **index** is the
+> only artifact loaded into mandatory task context — individual ADR bodies
+> under `decisions/` are **lazy / link-followed**, not auto-loaded. This is
+> **index-only by default**: auto-loading every ADR body into each task's
+> context would reintroduce exactly the bloat the split exists to remove.
+> `project.docsContextFiles` entries are plain filenames resolved against the
+> docs root (no glob expansion in the loader), so the index ships as a normal
+> mandatory-read with no loader change. A project that genuinely wants the full
+> ADR set in mandatory context can add explicit per-file entries (or a
+> `decisions/*.md`-style entry if it maintains its own globbing) as a
+> deliberate opt-in, but that is the exception, not the default.
+
 ### ADR Template
 
-Store ADRs in `docs/decisions/` with sequential numbering:
+In the **single-file** layout, append a short dated entry per the
+`templates/docs/decisions.md` format. In the **directory** layout, store ADRs
+in `docs/decisions/` with sequential numbering:
 
 ```markdown
 # ADR-001: Use PostgreSQL for primary database
@@ -69,6 +101,10 @@ Accepted | Superseded by ADR-XXX | Deprecated
 
 2025-01-15
 
+## Deciders
+
+The platform team (architect + two senior engineers).
+
 ## Context
 
 We need a primary database for the task management application. Key

package/.agents/templates/docs/architecture.md

@@ -27,4 +27,7 @@ Describe the top-level directories and their responsibilities.
 
 ## Key Decisions
 
-Link to `decisions.md` for the architectural decision log.
+Link to `decisions.md` for the architectural decision log. Mandrel supports two
+first-class layouts for it: a single-file dated-entry `decisions.md` (default)
+or an index + `decisions/` ADR directory — see
+[`.agents/skills/core/documentation-and-adrs/SKILL.md`](../../skills/core/documentation-and-adrs/SKILL.md).

package/.agents/templates/docs/decisions/_template.md

@@ -0,0 +1,35 @@
+# ADR-NNNN: <short decision title>
+
+> Copy this file to `decisions/NNNN-<kebab-title>.md` (zero-padded, sequential
+> — `0001`, `0002`, …) and add a matching row to the `decisions.md` index.
+> ADRs are **append-only**: never rewrite or delete an accepted ADR — supersede
+> it with a new one and flip this one's **Status** to `Superseded by ADR-NNNN`.
+
+## Status
+
+Accepted
+
+<!-- One of: Proposed | Accepted | Superseded by ADR-NNNN | Deprecated -->
+
+## Date
+
+YYYY-MM-DD
+
+## Deciders
+
+<!-- Who made the call (names / roles / "the team"). -->
+
+## Context
+
+<!-- What forced the decision: the constraint, problem, or trade-off. What
+were the requirements and the forces in tension? -->
+
+## Decision
+
+<!-- What was chosen, stated plainly. -->
+
+## Consequences
+
+<!-- What this enables and what it costs going forward — positive and negative.
+Include follow-on work, new constraints, and anything a future reader must
+know before reversing this. -->

package/.agents/templates/docs/decisions.index.md

@@ -0,0 +1,49 @@
+# Architectural Decisions Log (Index)
+
+> **Directory-layout variant.** This is the MADR-style **index + `decisions/`
+> directory** alternative to the default single-file dated-entry
+> [`decisions.md`](decisions.md). To adopt it, replace your `decisions.md` with
+> this index, create a `decisions/` directory next to it, and scaffold ADRs
+> from [`decisions/_template.md`](decisions/_template.md). This file stays named
+> `decisions.md` so it remains the `project.docsContextFiles` mandatory-read
+> every `.agents/` reference and `config-resolver.js` already point at — only
+> its **shape** changes from dated entries to an index.
+>
+> Prefer this layout once the single-file log grows past a few dozen entries
+> (athportal hit ~1060 lines / 32 ADRs before splitting). For small projects,
+> keep the default single-file template instead.
+
+## How this layout works
+
+- **This file is the index** — one row per ADR, newest at the top. It is the
+  mandatory-read; agents scan the index and follow the link into a specific
+  ADR only when the detail is relevant (index-only by default — see
+  [Loading model](#loading-model)).
+- **Each ADR is its own file** under `decisions/`, named
+  `NNNN-<kebab-title>.md` with a zero-padded sequential number.
+- **ADRs are append-only.** Never rewrite or delete an accepted ADR — write a
+  new one and flip the old one's status to `Superseded by ADR-NNNN`.
+- **Scaffold new ADRs** from [`decisions/_template.md`](decisions/_template.md)
+  (Status / Date / Deciders / Context / Decision / Consequences).
+
+## Loading model
+
+This index is the only decisions artifact loaded into mandatory task context
+(`project.docsContextFiles`). Individual ADR bodies under `decisions/` are
+**lazy / link-followed**, not auto-loaded — that is the whole point of the
+split: keep the per-task context lean while preserving the full decision
+history on disk. If a project genuinely wants the entire ADR set in mandatory
+context, it can add an explicit `decisions/*.md`-style entry to
+`project.docsContextFiles` as an opt-in (see the configuration reference), but
+index-only is the intended default.
+
+## Index
+
+| ADR      | Title                                    | Status   | Date       |
+| -------- | ---------------------------------------- | -------- | ---------- |
+| ADR-0001 | _Example — replace with your first ADR_  | Proposed | YYYY-MM-DD |
+
+_Add new rows above this line, newest first. Once you scaffold a real ADR from
+[`decisions/_template.md`](decisions/_template.md) into
+`decisions/0001-<title>.md`, link the ADR id to that file (e.g.
+`[ADR-0001](decisions/0001-<title>.md)`) and delete this example row._

package/.agents/templates/docs/decisions.md

@@ -4,6 +4,17 @@
 > decisions here as dated entries. This file is one of the
 > `project.docsContextFiles` mandatory-reads — agents consult it before every
 > task to avoid re-litigating settled choices.
+>
+> **Two supported layouts — pick one at onboarding.** This single-file
+> dated-entry layout is the **default**, ideal for small projects. Once the
+> log grows past a few dozen entries it becomes a context-bloat liability;
+> at that point switch to the first-class **index + `decisions/` directory**
+> variant ([`decisions.index.md`](decisions.index.md) + the ADR scaffold at
+> [`decisions/_template.md`](decisions/_template.md)). Both layouts keep the
+> file named `decisions.md` so the `project.docsContextFiles` mandatory-read
+> resolves the same; only the shape differs. See
+> [`.agents/skills/core/documentation-and-adrs/SKILL.md`](../../skills/core/documentation-and-adrs/SKILL.md)
+> for when to choose which.
 
 ## Format
 

package/.agents/workflows/helpers/plan-story.md

@@ -97,7 +97,7 @@ Envelope fields (`kind: "story-plan-context"`, `version: 1`):
 | `bodyTemplate`         | Contents of `.agents/templates/single-story-body.md`.     |
 | `requiredSections`     | `["Context", "Acceptance Criteria", "Out of Scope", "Notes"]`. |
 | `duplicateCandidates`  | Ranked open Stories whose titles fuzzy-match the seed.    |
-| `techStack`            | The `## Tech Stack` section of `docs/architecture.md`.    |
+| `techStack`            | The project's Tech Stack inventory, resolved in order: `docs/tech-stack.md` (full body) when present, else the `## Tech Stack` section of `docs/architecture.md` (numbered/decorated and final-section headings tolerated). |
 | `deliverContract`      | Workflow path + required/forbidden labels and references. |
 
 ### Refine heuristic

package/docs/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.74.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.73.0...mandrel-v1.74.0) (2026-06-19)
+
+
+### Added
+
+* minimize install footprint: drop Project views, make the board + custom-fields + issue-forms decoration opt-in (default off) ([#4234](https://github.com/dsj1984/mandrel/issues/4234)) ([#4235](https://github.com/dsj1984/mandrel/issues/4235)) ([9c8acf6](https://github.com/dsj1984/mandrel/commit/9c8acf6f8b324d3d2c221031f636680c823d5c2a))
+
+
+### Fixed
+
+* **bootstrap:** make quality gates and docs-stub scaffold opt-in and default-off ([#4240](https://github.com/dsj1984/mandrel/issues/4240)) ([e41da73](https://github.com/dsj1984/mandrel/commit/e41da7343e7fc1b55d1e1749f2e532b231426766))
+* **decompose:** enforce/default the mandatory type::story label on Story create → no more unlabeled, undispatchable Stories ([#4241](https://github.com/dsj1984/mandrel/issues/4241)) ([#4242](https://github.com/dsj1984/mandrel/issues/4242)) ([14d3752](https://github.com/dsj1984/mandrel/commit/14d3752f0bf8ed1133508e5c1955e60afb8d8a24))
+* **projects:** resolve organization-owned Projects v2 boards (refs [#4237](https://github.com/dsj1984/mandrel/issues/4237)) ([#4238](https://github.com/dsj1984/mandrel/issues/4238)) ([3c033c3](https://github.com/dsj1984/mandrel/commit/3c033c36a03ca68c94be0cfbee991ef33e7fa14d))
+
+## [1.73.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.72.0...mandrel-v1.73.0) (2026-06-17)
+
+
+### Added
+
+* generate GitHub issue forms from the Story/Epic body SSOT (human↔agent ticket consistency) ([#4227](https://github.com/dsj1984/mandrel/issues/4227)) ([#4233](https://github.com/dsj1984/mandrel/issues/4233)) ([d42b0cb](https://github.com/dsj1984/mandrel/commit/d42b0cb6122f46d8528d4bbb3793f27be2854bc1))
+* **plan:** robust tech-stack hydrator resolution (refs [#4228](https://github.com/dsj1984/mandrel/issues/4228)) ([#4230](https://github.com/dsj1984/mandrel/issues/4230)) ([4f1ad3c](https://github.com/dsj1984/mandrel/commit/4f1ad3c13b9a50f4e436d63282c7f6c2f461ab0e))
+
 ## [1.72.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.71.0...mandrel-v1.72.0) (2026-06-17)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mandrel",
-  "version": "1.72.0",
+  "version": "1.74.0",
   "description": "Claude Code-first opinionated workflow framework: instructions, personas, skills, and SDLC workflows that govern AI coding assistants.",
   "files": [
     ".agents/",