@flancer32/skill-adsm-ctx 0.2.1 → 0.3.0

package/src/Cli/Command/Upgrade.mjs

@@ -0,0 +1,19 @@
+// @ts-check
+
+import processModule from "node:process";
+
+/** @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_Upgrade */
+export default class Upgrade {
+  constructor({config, upgrade}) {
+    this.id = "adsm-ctx:upgrade";
+    this.summary = "Upgrade an ADSM context.";
+    this.lifetime = "finite";
+    this.execute = async function ({args}) {
+      const result = await upgrade.execute({targetPath: args["target-path"] ?? config.cwd});
+      processModule.stdout.write(`${result.message}\n`);
+      if (!result.ok) throw new Error(result.message);
+    };
+  }
+}
+
+export const __deps__ = Object.freeze({default: Object.freeze({config: "TeqFw_Cli_Config$", upgrade: "Fl32_Skill_Adsm_Ctx_Upgrade_Service$"})});

package/src/Cli/Command/Validate.mjs

@@ -0,0 +1,19 @@
+// @ts-check
+
+import processModule from "node:process";
+
+/** @namespace Fl32_Skill_Adsm_Ctx_Cli_Command_Validate */
+export default class Validate {
+  constructor({config, validate}) {
+    this.id = "adsm-ctx:validate";
+    this.summary = "Validate an ADSM context.";
+    this.lifetime = "finite";
+    this.execute = async function ({args}) {
+      const result = await validate.execute({targetPath: args["target-path"] ?? config.cwd});
+      processModule.stdout.write(`${validate.format({result})}\n`);
+      if (!result.ok) throw new Error("ADSM context validation failed.");
+    };
+  }
+}
+
+export const __deps__ = Object.freeze({default: Object.freeze({config: "TeqFw_Cli_Config$", validate: "Fl32_Skill_Adsm_Ctx_Validate_Service$"})});

package/src/Shared/Constants.mjs

@@ -9,10 +9,6 @@ export default class Constants {
   constructor() {
     this.CONTEXT_SCHEMA = "adsm-context";
     this.CONTEXT_VERSION = "0.1.0";
-    this.SKIN_WORD_WARN = 160;
-    this.SKIN_WORD_ERROR = 240;
-    this.SKIN_LIST_WARN = 12;
-    this.SKIN_LIST_ERROR = 20;
     this.DOC_LEVEL_MAX_DIRECTORIES = 9;
     this.DOC_LEVEL_MAX_FILES = 9;
     this.REQUIRED_PATHS = Object.freeze([

package/src/Validate/Service.mjs

@@ -5,14 +5,6 @@
  * @description Validates baseline ADSM context structure, metadata, and documentation projection shape.
  */
 
-const REQUIRED_SKIN_SECTIONS = Object.freeze([
-  "Purpose",
-  "Mental Model",
-  "Scope",
-  "Invariants",
-  "Agent Document",
-]);
-
 const LINK_PATTERN = /\[[^\]]+\]\(([^)]+)\)/g;
 const EXPLICIT_SKIN_FILENAME = /^(.*)\.skin\.([a-z]{2}(?:-[A-Za-z0-9]+)?)\.md$/;
 const LEGACY_SKIN_FILENAME = /^(.*)\.skin\.md$/;
@@ -586,129 +578,9 @@ function validateSkinDocument({bodySet, constants, file, skinInfo, text}) {
       severity: "error",
     }));
   }
-  const headings = extractLevelTwoHeadings(text);
-  for (const section of REQUIRED_SKIN_SECTIONS) {
-    if (!headings.includes(section)) {
-      findings.push(createFinding({
-        message: `Missing skin section "${section}": ${file}`,
-        path: file,
-        ruleId: "skin-required-sections",
-        severity: "error",
-      }));
-    }
-  }
-
-  const scopeText = extractSectionBody({sectionName: "Scope", text});
-  if (scopeText) {
-    if (!/^Includes:\s*$/m.test(scopeText)) {
-      findings.push(createFinding({
-        message: `Missing Includes: block in Scope: ${file}`,
-        path: file,
-        ruleId: "skin-scope-includes-excludes",
-        severity: "error",
-      }));
-    }
-    if (!/^Excludes:\s*$/m.test(scopeText)) {
-      findings.push(createFinding({
-        message: `Missing Excludes: block in Scope: ${file}`,
-        path: file,
-        ruleId: "skin-scope-includes-excludes",
-        severity: "error",
-      }));
-    }
-  }
-
-  const declaredReference = extractAgentDocumentReference(text);
-  if (!declaredReference) {
-    findings.push(createFinding({
-      message: `Missing Agent Document reference: ${file}`,
-      path: file,
-      ruleId: "skin-agent-document-reference",
-      severity: "error",
-    }));
-    findings.push(...validateSkinMetrics({constants, file, text}));
-    return findings;
-  }
-
-  const expectedReference = skinInfo.body;
-  const normalizedReference = normalizeAgentDocumentReference({reference: declaredReference, skinFile: file});
-  if (normalizedReference !== expectedReference) {
-    findings.push(createFinding({
-      message: `Skin agent document mismatch: ${file} references ${normalizedReference} but expected ${expectedReference}`,
-      path: file,
-      ruleId: "skin-agent-document-reference",
-      severity: "error",
-    }));
-  }
-  if (!bodySet.has(normalizedReference)) {
-    findings.push(createFinding({
-      message: `Missing paired agent document: ${file} references ${normalizedReference}`,
-      path: file,
-      ruleId: "skin-paired-agent-document",
-      severity: "error",
-    }));
-  }
-
-  findings.push(...validateSkinMetrics({constants, file, text}));
   return findings;
 }
 
-/**
- * @param {object} params
- * @param {Fl32_Skill_Adsm_Ctx_Shared_Constants} params.constants
- * @param {string} params.file
- * @param {string} params.text
- * @returns {{message: string, path: string, ruleId: string, severity: "error" | "warning"}[]}
- */
-function validateSkinMetrics({constants, file, text}) {
-  const findings = [];
-  const metricText = extractSkinMetricText(text);
-  const wordCount = countWords(metricText);
-  const listCount = countMeaningfulListItems(metricText);
-
-  if (wordCount > constants.SKIN_WORD_ERROR) {
-    findings.push(createFinding({
-      message: `Skin word count ${wordCount} exceeds limit ${constants.SKIN_WORD_ERROR}`,
-      path: file,
-      ruleId: "skin-size-word-count",
-      severity: "error",
-    }));
-  } else if (wordCount > constants.SKIN_WORD_WARN) {
-    findings.push(createFinding({
-      message: `Skin word count ${wordCount} exceeds warning threshold ${constants.SKIN_WORD_WARN}`,
-      path: file,
-      ruleId: "skin-size-word-count",
-      severity: "warning",
-    }));
-  }
-
-  if (listCount > constants.SKIN_LIST_ERROR) {
-    findings.push(createFinding({
-      message: `Skin list count ${listCount} exceeds limit ${constants.SKIN_LIST_ERROR}`,
-      path: file,
-      ruleId: "skin-size-list-count",
-      severity: "error",
-    }));
-  } else if (listCount > constants.SKIN_LIST_WARN) {
-    findings.push(createFinding({
-      message: `Skin list count ${listCount} exceeds warning threshold ${constants.SKIN_LIST_WARN}`,
-      path: file,
-      ruleId: "skin-size-list-count",
-      severity: "warning",
-    }));
-  }
-
-  return findings;
-}
-
-/**
- * @param {string} text
- * @returns {string[]}
- */
-function extractLevelTwoHeadings(text) {
-  return [...text.matchAll(/^##\s+(.+)$/gm)].map((match) => match[1].trim());
-}
-
 /**
  * @param {object} params
  * @param {string} params.sectionName
@@ -731,46 +603,6 @@ function extractSectionBody({sectionName, text}) {
   return body.join("\n");
 }
 
-/**
- * @param {string} text
- * @returns {string | null}
- */
-function extractAgentDocumentReference(text) {
-  const lines = text.split("\n");
-  let insideSection = false;
-  for (const rawLine of lines) {
-    const line = rawLine.trim();
-    if (!insideSection) {
-      if (line === "## Agent Document") insideSection = true;
-      continue;
-    }
-    if (line.startsWith("## ")) break;
-    if (line.length > 0) return line;
-  }
-  return null;
-}
-
-/**
- * @param {object} params
- * @param {string} params.reference
- * @param {string} params.skinFile
- * @returns {string}
- */
-function normalizeAgentDocumentReference({reference, skinFile}) {
-  let value = reference.trim();
-  const codeMatch = value.match(/^`(.+)`$/);
-  if (codeMatch) value = codeMatch[1].trim();
-  const linkMatch = value.match(/^\[[^\]]+\]\(([^)]+)\)$/);
-  if (linkMatch) value = linkMatch[1].trim();
-  if (value.startsWith("./")) value = value.slice(2);
-  if (value.startsWith("ctx/docs/")) return value;
-
-  const skinParts = skinFile.split("/");
-  skinParts.pop();
-  skinParts.push(value);
-  return normalizeRelativeSegments(skinParts).join("/");
-}
-
 /**
  * @param {object} params
  * @param {string} params.file
@@ -827,18 +659,13 @@ function stripFencedCodeBlocks(text) {
 }
 
 /**
- * Extracts semantic skin content while excluding metadata, headings, and the
- * Agent Document reference.
+ * Extracts all human-facing skin content while excluding metadata and headings.
  *
  * @param {string} text
  * @returns {string}
  */
 function extractSkinMetricText(text) {
-  return ["Purpose", "Mental Model", "Scope", "Invariants"]
-    .map((sectionName) => extractSectionBody({sectionName, text}))
-    .join("\n")
-    .replace(/^\s{0,3}#{1,6}\s+.*$/gm, "")
-    .replace(/^\s*(?:Includes|Excludes):\s*$/gm, "");
+  return stripSkinPresentation(text);
 }
 
 /**
@@ -846,11 +673,20 @@ function extractSkinMetricText(text) {
  * @returns {string}
  */
 function stripSkinPresentation(text) {
+  let insideLegacyReference = false;
   return stripFencedCodeBlocks(text)
     .split("\n")
-    .filter((line) => !/^#/.test(line.trim()))
-    .filter((line) => !/^- (?:Path|Changed): `[^`]+`$/.test(line.trim()))
-    .join("\n");
+    .filter((line) => {
+      const trimmed = line.trim();
+      if (/^##\s+Agent Document\s*$/.test(trimmed)) {
+        insideLegacyReference = true;
+        return false;
+      }
+      if (insideLegacyReference && /^##\s+/.test(trimmed)) insideLegacyReference = false;
+      return !insideLegacyReference && !/^#/.test(trimmed) && !/^- (?:Path|Changed): `[^`]+`$/.test(trimmed);
+    })
+    .join("\n")
+    .replace(/^\s*(?:Includes|Excludes):\s*$/gmu, "");
 }
 
 /**

package/types.d.ts

@@ -1,6 +1,9 @@
 declare global {
-  type Fl32_Skill_Adsm_Ctx_Bootstrap = import("./src/Bootstrap.mjs").default;
-  type Fl32_Skill_Adsm_Ctx_Bootstrap_Cli = import("./src/Bootstrap/Cli.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_Design = import("./src/Cli/Command/Design.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_Init = import("./src/Cli/Command/Init.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_InstallSkill = import("./src/Cli/Command/InstallSkill.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_Upgrade = import("./src/Cli/Command/Upgrade.mjs").default;
+  type Fl32_Skill_Adsm_Ctx_Cli_Command_Validate = import("./src/Cli/Command/Validate.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Design_Service = import("./src/Design/Service.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Init_Service = import("./src/Init/Service.mjs").default;
   type Fl32_Skill_Adsm_Ctx_Shared_Constants = import("./src/Shared/Constants.mjs").default;

package/.github/workflows/flows-app.yaml

@@ -1,95 +0,0 @@
-name: Upload Flows App Config
-
-on: workflow_dispatch
-
-env:
-  PRJ: flows-cfg-skill-adsm-ctx
-  CFG_SRC_DIR: ctx/agent/flows/cfg
-  CFG_ARCHIVE: flows-cfg-skill-adsm-ctx.tar.gz
-  CFG_TARGET_DIR: ${{ vars.FLOWS_CFG_DIR }}
-
-jobs:
-  upload:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v5
-
-      - name: Validate source directory
-        run: |
-          set -e
-
-          if [ ! -d "${{ env.CFG_SRC_DIR }}" ]; then
-            echo "Source directory does not exist: ${{ env.CFG_SRC_DIR }}"
-            exit 1
-          fi
-
-          find "${{ env.CFG_SRC_DIR }}" -mindepth 1 -print -quit | grep -q . || {
-            echo "Source directory is empty: ${{ env.CFG_SRC_DIR }}"
-            exit 1
-          }
-
-      - name: Build configuration archive
-        run: |
-          set -e
-
-          tar -C "${{ env.CFG_SRC_DIR }}" -czf "${{ env.CFG_ARCHIVE }}" .
-
-          ls -lh "${{ env.CFG_ARCHIVE }}"
-
-      - name: Copy archive to server
-        uses: appleboy/scp-action@master
-        with:
-          host: ${{ vars.FLOWS_HOST }}
-          username: ${{ vars.FLOWS_USER }}
-          key: ${{ secrets.FLOWS_SSH_KEY }}
-          source: ${{ env.CFG_ARCHIVE }}
-          target: /tmp
-
-      - name: Replace configuration on server
-        uses: appleboy/ssh-action@master
-        with:
-          host: ${{ vars.FLOWS_HOST }}
-          username: ${{ vars.FLOWS_USER }}
-          key: ${{ secrets.FLOWS_SSH_KEY }}
-          script: |
-            set -e
-
-            TARGET_DIR="${{ env.CFG_TARGET_DIR }}"
-            ARCHIVE="/tmp/${{ env.CFG_ARCHIVE }}"
-
-            if [ -z "$TARGET_DIR" ]; then
-              echo "CFG_TARGET_DIR is empty."
-              exit 1
-            fi
-
-            if [ "$TARGET_DIR" = "/" ]; then
-              echo "Refusing to replace root directory."
-              exit 1
-            fi
-
-            if [ ! -f "$ARCHIVE" ]; then
-              echo "Archive does not exist: $ARCHIVE"
-              exit 1
-            fi
-
-            PARENT_DIR="$(dirname "$TARGET_DIR")"
-            TARGET_NAME="$(basename "$TARGET_DIR")"
-            TIMESTAMP="$(date +%Y%m%d-%H%M%S)"
-            STAGING_DIR="$PARENT_DIR/.${TARGET_NAME}.new-$TIMESTAMP"
-
-            mkdir -p "$PARENT_DIR"
-
-            rm -rf "$STAGING_DIR"
-            mkdir -p "$STAGING_DIR"
-
-            tar -xzf "$ARCHIVE" -C "$STAGING_DIR"
-
-            rm -rf "$TARGET_DIR"
-            mv "$STAGING_DIR" "$TARGET_DIR"
-
-            rm -f "$ARCHIVE"
-
-            echo "Configuration uploaded to: $TARGET_DIR"
-            find "$TARGET_DIR" -maxdepth 3 -type f | sort

package/AGENTS.md

@@ -1,112 +0,0 @@
-# Root Level
-
-- Path: `AGENTS.md`
-- Template Version: `20260702`
-- Changed: `20260702`
-
-## Purpose
-
-This file defines the root-level working rules for the project repository.
-
-This file is the first instruction source for every agent operating within the repository.
-
-## Level Boundary
-
-Defines:
-
-- Root-level working boundaries between the repository, the cognitive context, and the software product.
-- Repository-topology rules needed to work safely when `ctx/` may be mounted separately.
-- Root-level protection and escalation rules for this project.
-
-Does NOT define:
-
-- Product-specific meaning, requirements, or domain knowledge.
-- Implementation-level structure such as source code, runtime details, or filesystem layout.
-- Task-specific instructions, workflows, or local operational procedures.
-
-## ADSM Project Model
-
-An ADSM project consists of two interconnected spaces:
-
-- the **Cognitive Context** located in `./ctx/`
-- the **Software Product** located outside `./ctx/`
-
-The cognitive context is the long-term textual memory of the project.
-
-The cognitive context is the primary communication medium between Humans and Agents working on the project.
-
-The cognitive context is the authoritative knowledge source used by Agents when modifying the project.
-
-The software product is the implementation that must be kept consistent with the cognitive context.
-
-## Human and Agent Roles
-
-The Human defines goals, authorizes work, evaluates outcomes, and evolves the project.
-
-The Agent interprets the cognitive context, performs assigned tasks, modifies the project within task boundaries, and maintains consistency between the cognitive context and the software product.
-
-The Agent operates through text and must treat project documentation as operational memory, not as secondary commentary.
-
-## Cognitive Context
-
-The canonical execution location of the cognitive context is `./ctx/`.
-
-Project-specific knowledge, requirements, architecture, environment descriptions, and implementation guidance are defined within the cognitive context.
-
-The Agent must consult `./ctx/AGENTS.md` for project-specific instructions when `./ctx/` exists.
-
-The Agent must consult `./ctx/docs/filesystem.md` for the project filesystem structure and documentation layout when that file exists.
-
-Documentation distributed with the software product may exist outside `./ctx/`, but it does not replace, redefine, or supersede the cognitive context.
-
-## Bootstrap and Repository Topology
-
-An ADSM project may use one repository or two repositories.
-
-In a one-repository topology, the software product and the cognitive context are versioned together.
-
-In a two-repository topology, the software product and the cognitive context are independent version-controlled repositories, and the cognitive context repository is mounted under `./ctx/`.
-
-The Agent must detect whether `./ctx/` is part of the current repository or an independent repository.
-
-The Agent must preserve repository boundaries.
-
-The Agent must not mix changes between independent repositories.
-
-The Agent must not remove, replace, relocate, or unmount `./ctx/`.
-
-If `./ctx/` does not exist, the Agent may perform bootstrap operations required to create the initial cognitive context structure.
-
-After bootstrap is complete, `./ctx/AGENTS.md` becomes the entry point for project-specific instructions.
-
-## Context and Product Consistency
-
-The cognitive context is the source of truth for the project.
-
-If the cognitive context and the software product diverge, the Agent must treat the cognitive context as authoritative.
-
-The Agent must maintain consistency between the cognitive context and the software product.
-
-The Agent may modify the cognitive context when required by the assigned task and when the modification remains consistent with higher-level context constraints.
-
-The Agent may modify the software product when required by the assigned task and when the modification remains consistent with the cognitive context.
-
-## AGENTS.md Hierarchy
-
-Additional `AGENTS.md` files may exist in subdirectories.
-
-The effective working context of the agent is the aggregate of all `AGENTS.md` files located along the path from the repository root to the target directory.
-
-Rules:
-
-- deeper levels override higher levels within their scope
-- root-level invariants cannot be overridden
-- all levels must remain mutually consistent
-
-## Root File Protection
-
-This file defines root-level project control rules.
-
-The agent must not modify, replace, delete, relocate, or reinterpret this file unless explicitly instructed by the human.
-
-Violation of this rule constitutes an execution error.

package/bin/cli.mjs

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import processModule from "node:process";
-import {fileURLToPath} from "node:url";
-
-import Container from "@teqfw/di/src/Container.mjs";
-import NamespaceRegistry from "@teqfw/di/src/Config/NamespaceRegistry.mjs";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const packageRoot = path.resolve(__dirname, "..");
-const projectRoot = processModule.cwd();
-
-const container = new Container();
-const namespaceRegistry = new NamespaceRegistry({fs, path, appRoot: packageRoot});
-const entries = await namespaceRegistry.build();
-
-for (const entry of entries) {
-  container.addNamespaceRoot(entry.prefix, entry.dirAbs, entry.ext);
-}
-
-const cliArgs = processModule.argv.slice(2);
-const app = await container.get("Fl32_Skill_Adsm_Ctx_Bootstrap$");
-
-let exitCode = 1;
-let stopRequested = false;
-
-const stopApp = async function () {
-  if (stopRequested) return;
-  stopRequested = true;
-  try {
-    await app.stop();
-  } catch (error) {
-    console.error(error);
-  }
-};
-
-for (const signal of ["SIGINT", "SIGTERM"]) {
-  processModule.once(signal, () => {
-    void stopApp();
-  });
-}
-
-try {
-  exitCode = await app.run({projectRoot, cliArgs});
-} catch (error) {
-  console.error(error);
-  exitCode = 1;
-} finally {
-  await stopApp();
-}
-
-processModule.exit(typeof exitCode === "number" ? exitCode : 1);

package/ctx/AGENTS.md

@@ -1,44 +0,0 @@
-# Cognitive Context
-
-- Path: `ctx/AGENTS.md`
-- Template Version: `20260702`
-- Changed: `20260707`
-
-## Purpose
-
-This file marks `ctx/` as the project cognitive context.
-
-Use this branch for project knowledge and keep detailed ADSM methodology outside the project-facing context.
-
-## Bootstrap Marker
-
-- This context follows ADSM conventions.
-- Use skill `adsm-ctx` for structure validation, upgrade logic, and methodology rules.
-
-## Level Map
-
-- `agent/` — project-local agent and tool materials outside the reusable ADSM baseline.
-- `assets/` — visual, generated, rendered, or auxiliary artifacts that support documentation without defining authoritative meaning.
-- `docs/` — project-facing documentation and constraints.
-- `AGENTS.md` — level definition for `ctx/`.
-- `README.md` — short entry note for the cognitive context.
-- `adsm.json` — context metadata for versioning and upgrade eligibility.
-
-## Level Boundary
-
-Defines:
-
-- `ctx/` as the project cognitive context boundary.
-- The split between project-facing documentation and project-local agent materials.
-- The local entry points agents should read before deeper work.
-
-Does NOT define:
-
-- Product-specific meaning that belongs in subordinate product and architecture documents.
-- Implementation structure outside the cognitive context.
-- Detailed ADSM methodology that belongs to the skill and its references.
-
-## Local Reading Map
-
-- Read `README.md` for a short entry note.
-- Read `docs/filesystem.md` for the top-level repository map.

package/ctx/README.md

@@ -1,24 +0,0 @@
-# Cognitive Context
-
-- Path: `ctx/README.md`
-- Template Version: `20260623`
-- Changed: `20260702`
-
-## Purpose
-
-This directory contains the project cognitive context.
-
-The cognitive context is the authoritative project knowledge space used by humans and agents when maintaining the project.
-
-## Entry Points
-
-- Read `AGENTS.md` for cognitive-context structure and governance rules.
-- Read `docs/filesystem.md` for the top-level repository map.
-- Read `docs/` for declarative project documentation.
-- Read `agent/` only when working with repository-local agent operations or workflow assets.
-
-## Boundary
-
-This directory defines project knowledge and agent-operational context.
-
-It does not replace product source code, runtime configuration, deployment secrets, or generated build artifacts.

package/ctx/adsm.json

@@ -1,5 +0,0 @@
-{
-  "schema": "adsm-context",
-  "version": "0.1.0",
-  "initializedAt": "2026-06-04"
-}

package/ctx/agent/AGENTS.md

@@ -1,41 +0,0 @@
-# Agent External Context
-
-- Path: `ctx/agent/AGENTS.md`
-- Changed: `20260707`
-
-## Purpose
-
-Defines the boundary of `ctx/agent/` for this repository.
-
-This branch is reserved for materials that document relationships, routines, and tool-facing instructions that sit outside ADSM methodology.
-
-Only this file belongs to the ADSM template baseline for `ctx/agent/`.
-
-Humans and agents may create project-local subdirectories here when they need instructions or records tied to a concrete tool or relationship, such as `github-flows`.
-
-## Level Map
-
-- `flows/` — operational workflow documentation and configuration for repository automation driven by labels and GitHub events.
-- `prompt/` — prompt definitions used by agents when generating or maintaining repository-facing context artifacts.
-- `report/` — task-specific agent reports produced during repository-local analysis or maintenance work.
-- `AGENTS.md` — level definition for `ctx/agent/`.
-
-## Level Boundary
-
-Defines:
-
-- The reserved role of `ctx/agent/` as a repository-local branch outside ADSM methodology.
-- The boundary between ADSM-governed context and project-local agent or tool materials.
-- The rule that only `ctx/agent/AGENTS.md` is part of the template-managed baseline for this branch.
-
-Does NOT define:
-
-- Product meaning, domain scope, or user-facing requirements.
-- Architecture ownership, system structure, or product-level engineering constraints.
-- The required shape of project-local subdirectories created for concrete tools or relationships.
-
-## Operational Constraints
-
-- Materials placed under project-local subdirectories in `ctx/agent/` remain outside ADSM methodology unless a higher-level context document explicitly says otherwise.
-- Tool-specific instructions under this branch must stay consistent with authoritative constraints in `ctx/docs/`.
-- Changes that alter agent authority or escalation expectations must remain consistent with `ctx/docs/architecture/supervision.md`.