coding-agent-harness 1.0.7 → 1.1.0

package/templates/dashboard/assets/css-src/40-detail-modules-migration.css

@@ -288,33 +288,210 @@
   font-weight: 500;
 }
 
-/* Module Grid */
-.module-grid {
+/* Module Console */
+.module-console {
+  min-width: 0;
+}
+
+.module-run-strip {
   display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(min(100%, 400px), 1fr));
+  grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
+  gap: 12px;
+}
+
+.module-console-grid {
+  display: grid;
+  grid-template-columns: minmax(240px, 300px) minmax(0, 1fr);
   gap: 16px;
+  align-items: start;
 }
 
-.module-card {
-  padding: 24px;
+.module-list-panel,
+.module-detail-panel,
+.module-unclassified-panel {
+  background: var(--paper);
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  box-shadow: var(--shadow);
 }
 
-.module-more {
-  display: inline-flex;
-  margin-top: 14px;
-  padding: 8px 16px;
+.module-list-panel {
+  display: grid;
+  gap: 6px;
+  padding: 8px;
+  position: sticky;
+  top: 84px;
+}
+
+.module-list-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 12px;
+  border: 1px solid transparent;
+  border-radius: 6px;
+  color: var(--ink);
+  text-decoration: none;
+  min-width: 0;
+}
+
+.module-list-item:hover,
+.module-list-item.active {
+  background: var(--paper-2);
+  border-color: var(--accent);
+}
+
+.module-list-item strong,
+.module-list-item small {
+  display: block;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.module-list-item small {
+  margin-top: 3px;
+  color: var(--muted);
+  font-size: 11px;
+  font-weight: 600;
+}
+
+.module-list-counts {
+  display: grid;
+  justify-items: end;
+  gap: 4px;
+  flex-shrink: 0;
+}
+
+.module-list-counts b {
+  font-size: 18px;
+}
+
+.module-detail-panel {
+  padding: 22px;
+  min-width: 0;
+}
+
+.module-detail-stack {
+  display: grid;
+  gap: 18px;
+  min-width: 0;
+}
+
+.module-detail-header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+  border-bottom: 1px solid var(--line);
+  padding-bottom: 16px;
+}
+
+.module-detail-header h2 {
+  margin: 2px 0 4px;
+  font-size: 24px;
+  line-height: 1.2;
+}
+
+.module-chip-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 8px;
+}
+
+.module-chip {
+  max-width: 100%;
+  padding: 4px 8px;
+  border: 1px solid var(--line);
   border-radius: 999px;
   background: var(--paper-2);
+  color: var(--muted);
+  font-size: 11px;
+  font-weight: 700;
+  overflow-wrap: anywhere;
+}
+
+.module-boundary-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 10px;
+}
+
+.module-boundary-block {
+  display: grid;
+  gap: 6px;
+  padding: 12px;
+  background: var(--paper-2);
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  min-width: 0;
+}
+
+.module-boundary-block strong {
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.module-boundary-block span {
+  font-size: 12px;
+  color: var(--muted);
+  overflow-wrap: anywhere;
+}
+
+.module-work-panel,
+.module-risk-panel,
+.module-doc-panel {
+  display: grid;
+  gap: 12px;
+  min-width: 0;
+}
+
+.module-risk-panel {
+  padding-top: 14px;
+  border-top: 1px solid var(--line);
+}
+
+.module-risk-panel h3,
+.module-doc-panel h3,
+.module-work-panel h3 {
+  margin: 0;
+  font-size: 15px;
+}
+
+.module-doc-links {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.module-doc-link {
+  max-width: 100%;
+  padding: 6px 8px;
   border: 1px solid var(--line);
+  border-radius: 6px;
+  color: var(--muted);
   font-size: 12px;
   font-weight: 700;
-  transition: all 0.2s ease;
+  overflow-wrap: anywhere;
 }
 
-.module-more:hover {
-  background: var(--accent);
-  color: var(--paper);
-  border-color: var(--accent);
+.module-doc-link.missing {
+  color: var(--danger);
+}
+
+.module-doc-preview {
+  max-height: 280px;
+  overflow: auto;
+  border-top: 1px solid var(--line);
+  padding-top: 12px;
+}
+
+.module-unclassified-panel {
+  padding: 18px;
+  border-color: color-mix(in srgb, var(--danger) 36%, var(--line));
 }
 
 /* Migration workbench */

package/templates/dashboard/assets/css-src/50-responsive-overrides.css

@@ -245,6 +245,15 @@
   gap: 8px;
   min-width: 0;
 }
+
+.module-task-left small {
+  color: var(--muted);
+  font-size: 11px;
+  font-weight: 600;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
 .module-task-dot {
   width: 8px;
   height: 8px;
@@ -272,6 +281,20 @@
   margin-left: 8px;
 }
 
+@media (max-width: 900px) {
+  .module-console-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .module-list-panel {
+    position: static;
+  }
+
+  .module-boundary-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
 /* Inline card pagination controls */
 .module-pager {
   display: flex;

package/templates/dashboard/assets/i18n.js

@@ -5,6 +5,19 @@ window.HarnessI18n = {
     "overview": "Overview",
     "taskIndex": "Task Index",
     "reviewQueue": "Lifecycle Queue Workbench",
+    "archive": "Archive",
+    "archiveView": "Version Archive",
+    "archiveSubtitle": "Archived tasks are hidden from the normal cycle and grouped here by release or retention bucket.",
+    "archivedTasks": "Archived tasks",
+    "archiveBuckets": "Archive buckets",
+    "archiveUnclassified": "unclassified archive",
+    "noArchivedTasks": "No archived tasks in this snapshot.",
+    "archivedBy": "Archived by",
+    "archivedAt": "Archived at",
+    "reviewConfirmedBy": "Review confirmed by",
+    "reviewConfirmedAt": "Review confirmed at",
+    "reviewConfirmationId": "Review confirmation ID",
+    "releasePackage": "Release package",
     "moduleView": "Modules",
     "readiness": "Readiness",
     "snapshotStatus": "Snapshot status",
@@ -80,6 +93,21 @@ window.HarnessI18n = {
     "moduleBriefMissing": "Module brief missing. Add a module-level visibility brief before treating module migration as complete.",
     "moduleTasks": "Module Tasks",
     "noModuleTasks": "No module tasks.",
+    "registeredModule": "Registered module",
+    "moduleRegistered": "Registered",
+    "moduleActive": "Active modules",
+    "moduleRisks": "Risks",
+    "moduleUnclassified": "Unclassified",
+    "moduleOwner": "Owner",
+    "moduleBranch": "Branch",
+    "moduleCurrentStep": "Current step",
+    "moduleScope": "Scope",
+    "moduleShared": "Shared",
+    "moduleDependsOn": "Depends on",
+    "moduleCurrentWork": "Current work",
+    "moduleRiskPanel": "Risk and coordination",
+    "unclassifiedWarning": "Needs classification",
+    "unclassifiedSummary": "{count} tasks are not attached to a registered module.",
     "migration": "Migration",
     "migrationSummary": "Migration Attention",
     "migrationWorkbench": "Migration Workbench",
@@ -106,6 +134,8 @@ window.HarnessI18n = {
     "group_month": "Month",
     "group_state": "State",
     "inferredModule": "Module",
+    "baseModule": "Base",
+    "baseModuleEyebrow": "Project root",
     "unclassifiedModule": "legacy-unclassified",
     "visibilityLayer": "Visibility Layer",
     "lessons": "Lessons",
@@ -139,6 +169,7 @@ window.HarnessI18n = {
     "state_snapshot": "snapshot",
     "state_in_progress": "in progress",
     "state_planned": "planned",
+    "state_not_started": "not started",
     "state_review": "review",
     "state_blocked": "blocked",
     "state_done": "done",
@@ -173,6 +204,29 @@ window.HarnessI18n = {
     "layout": "View Layout",
     "layoutList": "List View",
     "layoutGrid": "Grid View",
+    "layoutSwimlane": "Swimlane",
+    "swimlaneEyebrow": "Runtime map",
+    "swimlaneTitle": "Active Work Swimlane",
+    "swimlaneHeatmapLabel": "Heatmap overview",
+    "swimlaneModuleColumn": "Module",
+    "swimlaneTotalColumn": "Total",
+    "swimlaneDrilldownLabel": "Drilldown",
+    "swimlaneCollapse": "Collapse",
+    "swimlanePageLabel": "Page",
+    "swimlanePrevPage": "Prev",
+    "swimlaneNextPage": "Next",
+    "swimlaneViewStage": "Open stage",
+    "swimlaneEmpty": "No active task fits the swimlane filters.",
+    "swimlaneNeedsEvidence": "Evidence needs attention",
+    "swimlaneReadyToConfirm": "Ready for human confirmation",
+    "swimlaneNeedsCloseout": "Closeout still missing",
+    "swimlaneStagePlanned": "Planned",
+    "swimlaneStageInProgress": "In progress",
+    "swimlaneStageEvidence": "Evidence",
+    "swimlaneStageReview": "Review",
+    "swimlaneStageConfirmed": "Confirmed",
+    "swimlaneStageCloseout": "Closeout",
+    "swimlaneStageBlocked": "Blocked",
     "sortByTime": "Time order",
     "sortNewest": "Newest first",
     "sortOldest": "Oldest first",
@@ -194,6 +248,8 @@ window.HarnessI18n = {
     "state_in_review": "in review",
     "state_review-blocked": "review blocked",
     "state_closed-review-pending": "closed, review pending",
+    "state_confirmed-finalization-pending": "confirmed, closeout pending",
+    "state_lesson-finalization-pending": "confirmed, lessons pending",
     "state_missing": "missing",
     "state_required": "required",
     "state_agent-reviewed": "agent reviewed",
@@ -228,7 +284,7 @@ window.HarnessI18n = {
     "queueConfirmedFinalized": "Confirmed / Finalized",
     "queueConfirmedFinalizedDesc": "Human-confirmed tasks and finalized records kept for audit and closeout follow-through.",
     "queueSoftDeletedSuperseded": "Soft-deleted / Superseded",
-    "queueSoftDeletedSupersededDesc": "Historical tasks with tombstones, replacements, merges, archives, or abandoned state.",
+    "queueSoftDeletedSupersededDesc": "Historical tasks with tombstones, replacements, merges, or archives; abandoned and duplicate semantics are shown as reasons.",
     "reasonFilter": "Reason filter",
     "allReasons": "All reasons",
     "reason": "Reason",
@@ -243,6 +299,26 @@ window.HarnessI18n = {
     "copyRepairPromptSuccess": "Prompt copied",
     "copyLessonPrompt": "Copy lesson prompt",
     "createLessonTask": "Create sedimentation task",
+    "select": "Select",
+    "clearSelection": "Clear selection",
+    "selectReviewTask": "Select review task",
+    "selectAllReviewTasks": "Select all confirmable reviews",
+    "reviewBulkSelected": "{count} selected",
+    "reviewBulkConfirm": "Confirm selected",
+    "reviewBulkNone": "No confirmable reviews selected.",
+    "reviewBulkSubmitting": "Confirming selected reviews...",
+    "reviewBulkSuccess": "Confirmed {confirmed} reviews. Reloading snapshot...",
+    "reviewBulkPartial": "Confirmed {confirmed}; {failed} failed.",
+    "bulkActionFailedWithReason": "{failed} failed: {reason}",
+    "bulkActionFailedSummary": "{failed} failed.",
+    "selectLessonCandidate": "Select lesson candidate",
+    "selectAllLessonCandidates": "Select all actionable lessons",
+    "lessonBulkSelected": "{count} selected",
+    "lessonBulkCreate": "Create aggregate task",
+    "lessonBulkNone": "No lesson candidates selected.",
+    "lessonBulkSubmitting": "Creating aggregate lesson task...",
+    "lessonBulkSuccess": "Created 1 aggregate task for {candidates} candidates. Reloading snapshot...",
+    "lessonBulkPartial": "Created {created}; {failed} failed.",
     "openFollowUpTask": "Open follow-up task",
     "lessonSedimentationActions": "Sedimentation actions",
     "lessonWorkbenchRequired": "Creation is available in the dynamic workbench. The prompt can still be copied from this snapshot.",
@@ -258,6 +334,8 @@ window.HarnessI18n = {
     "reviewConfirmedQueue": "Confirmed",
     "noReviewTasks": "No tasks are currently in review.",
     "reviewAlreadyConfirmed": "Human review is already confirmed.",
+    "reviewConfirmedCloseoutReady": "Human review is confirmed and Lesson routing is complete. This task can be closed.",
+    "reviewConfirmedLessonPending": "Human review is confirmed, but Lesson sedimentation or promotion is still pending.",
     "reviewBlocked": "Close P0-P2 open or release-blocking findings before confirming.",
     "reviewWalkthroughRequired": "Add the task-local walkthrough.md before confirming human review.",
     "reviewQueueRequired": "This task is not in the canonical Review queue.",
@@ -269,6 +347,10 @@ window.HarnessI18n = {
     "reviewSubmitting": "Submitting review confirmation...",
     "reviewCompleteSuccess": "Review confirmed. Reloading snapshot...",
     "reviewCompleteFailed": "Review confirmation failed",
+    "completeTaskCloseout": "Complete Closeout",
+    "taskCloseoutSubmitting": "Completing closeout...",
+    "taskCloseoutSuccess": "Task closed. Reloading snapshot...",
+    "taskCloseoutFailed": "Task closeout failed",
     "presetCatalog": "Presets",
     "presetCatalogSubtitle": "Manage project, user, and bundled task method packages. Precedence is project first, then user, then bundled.",
     "presetSearch": "Search presets",
@@ -341,6 +423,19 @@ window.HarnessI18n = {
     "overview": "总览",
     "taskIndex": "任务索引",
     "reviewQueue": "生命周期队列工作台",
+    "archive": "归档",
+    "archiveView": "版本归档",
+    "archiveSubtitle": "已归档任务会从正常周期隐藏，并在这里按版本或保留桶分组查看。",
+    "archivedTasks": "已归档任务",
+    "archiveBuckets": "归档分组",
+    "archiveUnclassified": "未分类归档",
+    "noArchivedTasks": "当前快照没有已归档任务。",
+    "archivedBy": "归档人",
+    "archivedAt": "归档时间",
+    "reviewConfirmedBy": "审查确认人",
+    "reviewConfirmedAt": "审查确认时间",
+    "reviewConfirmationId": "审查确认 ID",
+    "releasePackage": "发布包",
     "moduleView": "模块",
     "readiness": "发布状态",
     "snapshotStatus": "快照状态",
@@ -416,6 +511,21 @@ window.HarnessI18n = {
     "moduleBriefMissing": "模块 brief 缺失。迁移完成前需要补一个模块级可见性 brief。",
     "moduleTasks": "模块任务",
     "noModuleTasks": "没有模块任务。",
+    "registeredModule": "已注册模块",
+    "moduleRegistered": "已注册",
+    "moduleActive": "活跃模块",
+    "moduleRisks": "风险",
+    "moduleUnclassified": "未分类",
+    "moduleOwner": "负责人",
+    "moduleBranch": "分支",
+    "moduleCurrentStep": "当前步骤",
+    "moduleScope": "范围",
+    "moduleShared": "共享面",
+    "moduleDependsOn": "依赖",
+    "moduleCurrentWork": "当前工作",
+    "moduleRiskPanel": "风险与协调",
+    "unclassifiedWarning": "需要分类",
+    "unclassifiedSummary": "{count} 个任务还没有挂到已注册模块。",
     "migration": "迁移",
     "migrationSummary": "迁移关注项",
     "migrationWorkbench": "迁移工作台",
@@ -442,6 +552,8 @@ window.HarnessI18n = {
     "group_month": "月份",
     "group_state": "状态",
     "inferredModule": "模块",
+    "baseModule": "Base（未分模块）",
+    "baseModuleEyebrow": "根任务",
     "unclassifiedModule": "未分类历史任务",
     "visibilityLayer": "可见性层",
     "lessons": "教训",
@@ -468,6 +580,7 @@ window.HarnessI18n = {
     "state_snapshot": "快照",
     "state_in_progress": "进行中",
     "state_planned": "计划中",
+    "state_not_started": "未开始",
     "state_review": "审查中",
     "state_blocked": "阻塞",
     "state_done": "完成",
@@ -509,6 +622,29 @@ window.HarnessI18n = {
     "layout": "展示布局",
     "layoutList": "列表布局",
     "layoutGrid": "网格布局",
+    "layoutSwimlane": "泳道图",
+    "swimlaneEyebrow": "运行态地图",
+    "swimlaneTitle": "活跃任务泳道",
+    "swimlaneHeatmapLabel": "热力图鸟瞰",
+    "swimlaneModuleColumn": "模块",
+    "swimlaneTotalColumn": "合计",
+    "swimlaneDrilldownLabel": "下钻看板",
+    "swimlaneCollapse": "收起",
+    "swimlanePageLabel": "页",
+    "swimlanePrevPage": "上一页",
+    "swimlaneNextPage": "下一页",
+    "swimlaneViewStage": "查看阶段",
+    "swimlaneEmpty": "当前筛选下没有可进入泳道图的活跃任务。",
+    "swimlaneNeedsEvidence": "证据需要补齐",
+    "swimlaneReadyToConfirm": "等待人工确认",
+    "swimlaneNeedsCloseout": "仍缺少结项材料",
+    "swimlaneStagePlanned": "计划",
+    "swimlaneStageInProgress": "执行",
+    "swimlaneStageEvidence": "证据",
+    "swimlaneStageReview": "审查",
+    "swimlaneStageConfirmed": "已确认",
+    "swimlaneStageCloseout": "结项",
+    "swimlaneStageBlocked": "阻塞",
     "sortByTime": "时间排序",
     "sortNewest": "最新优先",
     "sortOldest": "最早优先",
@@ -530,6 +666,8 @@ window.HarnessI18n = {
     "state_in_review": "审查中",
     "state_review-blocked": "审查阻塞",
     "state_closed-review-pending": "已结项待人审",
+    "state_confirmed-finalization-pending": "已确认待结项",
+    "state_lesson-finalization-pending": "已确认待沉淀",
     "state_missing": "缺失",
     "state_required": "待审查",
     "state_agent-reviewed": "Agent 自查",
@@ -564,7 +702,7 @@ window.HarnessI18n = {
     "queueConfirmedFinalized": "Confirmed / Finalized",
     "queueConfirmedFinalizedDesc": "已经人工确认或最终结项的任务，用于审计和结项追踪。",
     "queueSoftDeletedSuperseded": "Soft-deleted / Superseded",
-    "queueSoftDeletedSupersededDesc": "带 tombstone、替代、合并、归档或废弃状态的历史任务。",
+    "queueSoftDeletedSupersededDesc": "带 tombstone、替代、合并或归档的历史任务；废弃和重复等语义显示为原因。",
     "reasonFilter": "原因筛选",
     "allReasons": "全部原因",
     "reason": "原因",
@@ -579,6 +717,26 @@ window.HarnessI18n = {
     "copyRepairPromptSuccess": "已复制提示",
     "copyLessonPrompt": "复制沉淀提示",
     "createLessonTask": "创建沉淀任务",
+    "select": "选择",
+    "clearSelection": "清空选择",
+    "selectReviewTask": "选择审查任务",
+    "selectAllReviewTasks": "全选可确认审查",
+    "reviewBulkSelected": "已选择 {count} 项",
+    "reviewBulkConfirm": "确认所选",
+    "reviewBulkNone": "还没有选择可确认审查。",
+    "reviewBulkSubmitting": "正在批量确认审查...",
+    "reviewBulkSuccess": "已确认 {confirmed} 个审查，正在刷新快照...",
+    "reviewBulkPartial": "已确认 {confirmed} 个；{failed} 个失败。",
+    "bulkActionFailedWithReason": "{failed} 个失败：{reason}",
+    "bulkActionFailedSummary": "{failed} 个失败。",
+    "selectLessonCandidate": "选择沉淀候选",
+    "selectAllLessonCandidates": "全选可沉淀经验",
+    "lessonBulkSelected": "已选择 {count} 项",
+    "lessonBulkCreate": "创建聚合任务",
+    "lessonBulkNone": "还没有选择沉淀候选。",
+    "lessonBulkSubmitting": "正在创建聚合沉淀任务...",
+    "lessonBulkSuccess": "已为 {candidates} 个候选创建 1 个聚合任务，正在刷新快照...",
+    "lessonBulkPartial": "已创建 {created} 个；{failed} 个失败。",
     "openFollowUpTask": "打开后续任务",
     "lessonSedimentationActions": "沉淀操作",
     "lessonWorkbenchRequired": "创建任务需要使用动态 workbench；当前快照仍可复制沉淀提示。",
@@ -594,6 +752,8 @@ window.HarnessI18n = {
     "reviewConfirmedQueue": "已确认",
     "noReviewTasks": "当前没有处在审查阶段的任务。",
     "reviewAlreadyConfirmed": "人工审查已经确认。",
+    "reviewConfirmedCloseoutReady": "人工审查已确认，Lesson 路由已完成，可以结项。",
+    "reviewConfirmedLessonPending": "人工审查已确认，但还有 Lesson 沉淀或 promotion 未完成。",
     "reviewBlocked": "先关闭 P0-P2 开放项或阻塞发布的发现，再确认审查。",
     "reviewWalkthroughRequired": "先补齐任务本地 walkthrough.md，再确认人工审查。",
     "reviewQueueRequired": "这个任务不在 canonical Review 队列中。",
@@ -605,6 +765,10 @@ window.HarnessI18n = {
     "reviewSubmitting": "正在提交审查确认...",
     "reviewCompleteSuccess": "审查已确认，正在刷新快照...",
     "reviewCompleteFailed": "审查确认失败",
+    "completeTaskCloseout": "完成结项",
+    "taskCloseoutSubmitting": "正在结项...",
+    "taskCloseoutSuccess": "任务已结项，正在刷新快照...",
+    "taskCloseoutFailed": "任务结项失败",
     "presetCatalog": "Preset",
     "presetCatalogSubtitle": "管理项目级、用户级和内置任务方法包。优先级是项目级、用户级、内置。",
     "presetSearch": "搜索 preset",

package/templates/development/README.md

@@ -12,8 +12,8 @@ This folder is the development input pack. It tells agents how to work in this r
 ## Boundary
 
 - Put local setup, codebase map, external service development summaries, mocks, stubs, and cross-repo debugging here.
-- Put long-lived system structure in `coding-agent-harness/context/architecture/`.
-- Put concrete API/event/webhook contracts in `coding-agent-harness/context/integrations/`.
+- Put long-lived system structure in `{{paths.harnessRoot}}/context/architecture/`.
+- Put concrete API/event/webhook contracts in `{{paths.harnessRoot}}/context/integrations/`.
 
 ## Structure Contract
 
@@ -30,21 +30,21 @@ This folder is the development input pack. It tells agents how to work in this r
 
 If this repository depends on multiple microservices, do not write all external knowledge into one large document. For any external service that affects local development or testing, create:
 
-- `coding-agent-harness/context/architecture/services/<service-key>.md`: what the service is and what it owns.
-- `coding-agent-harness/context/development/external-context/<service-key>.md`: how this repository mocks, stubs, or debugs it.
-- `coding-agent-harness/context/integrations/<contract>.md`: concrete API/event/webhook contracts.
+- `{{paths.harnessRoot}}/context/architecture/services/<service-key>.md`: what the service is and what it owns.
+- `{{paths.harnessRoot}}/context/development/external-context/<service-key>.md`: how this repository mocks, stubs, or debugs it.
+- `{{paths.harnessRoot}}/context/integrations/<contract>.md`: concrete API/event/webhook contracts.
 
 `context/development` only answers how to work with the external service during development. Do not maintain full system topology here, and do not put payload schemas here.
 
 ## External Source Pack Rule
 
-If an external team provides many documents, screenshots, exported packets, meeting notes, or links, do not place them directly into `context/{architecture,development,integrations}`. Read `coding-agent-harness/governance/standards/external-source-intake-standard.md` first, then decide whether `external-source-packs/<source-key>/` is needed.
+If an external team provides many documents, screenshots, exported packets, meeting notes, or links, do not place them directly into `context/{architecture,development,integrations}`. Read `{{paths.harnessRoot}}/governance/standards/external-source-intake-standard.md` first, then decide whether `external-source-packs/<source-key>/` is needed.
 
 `external-source-packs/` owns source indexes, digests, and projection status only. Stable conclusions must be written back to:
 
-- `coding-agent-harness/context/architecture/services/<service-key>.md`
-- `coding-agent-harness/context/development/external-context/<service-key>.md`
-- `coding-agent-harness/context/integrations/<contract>.md`
+- `{{paths.harnessRoot}}/context/architecture/services/<service-key>.md`
+- `{{paths.harnessRoot}}/context/development/external-context/<service-key>.md`
+- `{{paths.harnessRoot}}/context/integrations/<contract>.md`
 
 ## External Context Index
 

package/templates/development/cross-repo-debugging.md

@@ -8,9 +8,9 @@ Confidence: low
 ## Debug Flow
 
 1. Identify the failing interface or flow.
-2. Read `coding-agent-harness/context/architecture/service-catalog.md` for ownership and upstream/downstream services.
-3. Read the matching `coding-agent-harness/context/integrations/` contract.
-4. Use the matching `coding-agent-harness/context/development/external-context/<service-key>.md` notes for mocks and local debugging.
+2. Read `{{paths.harnessRoot}}/context/architecture/service-catalog.md` for ownership and upstream/downstream services.
+3. Read the matching `{{paths.harnessRoot}}/context/integrations/` contract.
+4. Use the matching `{{paths.harnessRoot}}/context/development/external-context/<service-key>.md` notes for mocks and local debugging.
 
 ## Known Failure Modes
 

package/templates/development/external-context/service-template.md

@@ -9,7 +9,7 @@ Confidence: low
 
 | Service Profile | Source Pack | Integration Contracts | Last Verified | Confidence |
 | --- | --- | --- | --- | --- |
-| `coding-agent-harness/context/architecture/services/<service-key>.md` | `coding-agent-harness/context/development/external-source-packs/<source-key>/README.md` or N/A | `coding-agent-harness/context/integrations/<contract>.md` | unknown | low |
+| `{{paths.harnessRoot}}/context/architecture/services/<service-key>.md` | `{{paths.harnessRoot}}/context/development/external-source-packs/<source-key>/README.md` or N/A | `{{paths.harnessRoot}}/context/integrations/<contract>.md` | unknown | low |
 
 ## Development Use
 

package/templates/development/external-source-packs/README.md

@@ -7,9 +7,9 @@ Confidence: low
 
 ## Purpose
 
-This directory is only for external source intake, indexing, and digests. Stable facts become Harness execution context only after they are projected into `context/architecture`, `coding-agent-harness/context/development/external-context`, or `context/integrations`.
+This directory is only for external source intake, indexing, and digests. Stable facts become Harness execution context only after they are projected into `context/architecture`, `{{paths.harnessRoot}}/context/development/external-context`, or `context/integrations`.
 
-Read `coding-agent-harness/governance/standards/external-source-intake-standard.md` before adding a source pack.
+Read `{{paths.harnessRoot}}/governance/standards/external-source-intake-standard.md` before adding a source pack.
 
 ## Source Packs
 

package/templates/integrations/README.md

@@ -11,8 +11,8 @@ This folder owns concrete interface contracts: APIs, events, webhooks, SDK usage
 
 ## Boundary
 
-- Put service topology and ownership in `coding-agent-harness/context/architecture/`.
-- Put development mocks and debugging notes in `coding-agent-harness/context/development/`.
+- Put service topology and ownership in `{{paths.harnessRoot}}/context/architecture/`.
+- Put development mocks and debugging notes in `{{paths.harnessRoot}}/context/development/`.
 - Put endpoint, payload, error, auth, event, webhook, and SDK contracts here.
 
 ## Structure Contract
@@ -28,8 +28,8 @@ This folder owns concrete interface contracts: APIs, events, webhooks, SDK usage
 
 Every interface contract must be its own file and link back to the related service:
 
-- Service ownership and topology: `coding-agent-harness/context/architecture/service-catalog.md` or `services/<service-key>.md`
-- Local mocks, stubs, and debugging: `coding-agent-harness/context/development/external-context/<service-key>.md`
+- Service ownership and topology: `{{paths.harnessRoot}}/context/architecture/service-catalog.md` or `services/<service-key>.md`
+- Local mocks, stubs, and debugging: `{{paths.harnessRoot}}/context/development/external-context/<service-key>.md`
 - Concrete payloads, auth, errors, and contract tests: this folder
 
 Do not mix multiple services into one large "integration notes" document. Multi-service systems should have multiple contract files; the Contract Index below is the navigation layer for humans and agents.