Another deep audit and production-hardening pass is complete. 104 tests, smoke, operator smoke, and production audit all pass.

Always-on per-project digest
The biggest change: project_steering_digest is now attached on every steering surface, not only when bootstrap placeholders remain.

New attach_steering_digest_fields() builds a compact identity card from project_fingerprint whenever a workspace resolves. attach_bootstrap_steering_fields() now:

Returns fill plan + preview + digest when bootstrap is incomplete
Returns digest only when bootstrap is complete (no empty {})
Wired through:

Surface	Behavior
enrich_payload_with_steering
Digest on all tool payloads; fill plan when bootstrap incomplete
session_brief
Digest always; fill plan when needed
build_progress_snapshot
Digest always
build_live_steering_brief
Always via unified attach
validate_roadmap
Digest when schema passes and bootstrap complete
explain_gate
Digest always; bootstrap suffix only when placeholders remain
Agents get per-project identity on guide, validate, progress, session start, and explain-gate — not just during bootstrap fill.

Fingerprint — CI & hooks (industry standard)
Signal	Source
ci_workflow_names
.github/workflows/*.yml / *.yaml stems
has_pre_commit
.pre-commit-config.yaml
Cache invalidation now includes workflow file mtimes so CI changes refresh the fingerprint.

Digest and live steering lines include Workflows and Hooks: pre-commit configured when present.

Production cleanup
Removed “manual edits” language from autofill operator summary
Progress telemetry (roadmap_hooks) records steering_brief, project_archetype, and verification_commands on tool events
Audit expansion
Verifies:

validate always includes project_steering_digest
progress and explain_gate always include digest with steering_brief
GitHub workflow name detection (ci from .github/workflows/ci.yml)
Architecture
project_fingerprint (always)
  → project_steering_digest (always on every surface)
  → bootstrap_fill_plan (only when placeholders remain)
  → apply_bootstrap_fill → validate → recommended_next_action
Per-project steering is now a persistent identity layer across the full roadmap lifecycle, with bootstrap autofill as a targeted phase rather than the only time project context appears.

Author: CardSorting

lib/agent/roadmap/agent_steering.py

@@ -60,6 +60,13 @@ def _project_context_lines(steering: dict[str, Any]) -> list[str]:
     if ci:
         lines.append(f"CI: {', '.join(ci[:2])}")
 
+    workflows = steering.get("ci_workflow_names") or []
+    if workflows:
+        lines.append(f"Workflows: {', '.join(workflows[:3])}")
+
+    if steering.get("has_pre_commit"):
+        lines.append("Hooks: pre-commit configured")
+
     git_remote = steering.get("git_remote")
     if git_remote:
         lines.append(f"Origin: {git_remote}")
@@ -185,8 +192,7 @@ def build_live_steering_brief(*, workspace: Optional[str] = None) -> dict[str, A
         "steering_line": format_agent_steering_line(workspace=steering.get("workspace") or workspace) or None,
         **steering,
     }
-    if steering.get("bootstrap_complete") is False:
-        from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_bootstrap_steering_fields
+    from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_bootstrap_steering_fields
 
-        out.update(attach_bootstrap_steering_fields(steering, tier="light"))
+    out.update(attach_bootstrap_steering_fields(steering, tier="light"))
     return out

lib/agent/roadmap/bootstrap_fill.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 import re
+from pathlib import Path
 from typing import Any, Optional
 
 from plugins.dietcode.lib.agent.roadmap.schema import find_bootstrap_placeholders
@@ -493,7 +494,7 @@ def apply_bootstrap_fill_draft(
         "operator_summary": (
             f"Applied {len(applied)} evidence-backed replacement(s); {len(remaining)} template phrase(s) remain."
             if applied
-            else f"No autofill applied — {len(remaining)} template phrase(s) remain — roadmap(action='apply_bootstrap_fill') or manual edits from bootstrap_fill_plan.tasks."
+            else f"No autofill applied — {len(remaining)} template phrase(s) remain — roadmap(action='apply_bootstrap_fill') or bootstrap_fill_plan.tasks."
         ),
     }
 
@@ -526,6 +527,8 @@ def build_project_steering_digest(
         "dependency_automation": fingerprint.get("dependency_automation"),
         "has_backstage_catalog": fingerprint.get("has_backstage_catalog"),
         "catalog_name": fingerprint.get("catalog_name"),
+        "ci_workflow_names": fingerprint.get("ci_workflow_names") or [],
+        "has_pre_commit": fingerprint.get("has_pre_commit"),
     }
     if fill_plan:
         digest["bootstrap_remaining"] = fill_plan.get("remaining_count")
@@ -564,15 +567,50 @@ def bootstrap_steering_bundle(
     return out
 
 
+def attach_steering_digest_fields(steering: dict[str, Any]) -> dict[str, Any]:
+    """Attach compact per-project digest whenever a workspace is resolved."""
+    root = steering.get("workspace")
+    if not root:
+        return {}
+    fp: dict[str, Any] = {}
+    try:
+        from plugins.dietcode.lib.agent.roadmap.project_fingerprint import build_project_fingerprint
+
+        fp = build_project_fingerprint(root)
+    except Exception:
+        fp = {
+            k: steering.get(k)
+            for k in (
+                "steering_brief",
+                "steering_identity",
+                "project_archetype",
+                "stack_summary",
+                "purpose_hint",
+                "verification_commands",
+                "entry_points",
+                "makefile_targets",
+                "agent_rules_files",
+                "git_remote",
+                "docs_roots",
+                "governance_files",
+                "workspace_packages",
+            )
+            if steering.get(k) is not None
+        }
+    if not fp:
+        fp = {"steering_identity": Path(str(root)).name}
+    return {"project_steering_digest": build_project_steering_digest(fp)}
+
+
 def attach_bootstrap_steering_fields(
     steering: dict[str, Any],
     *,
     tier: str = "light",
     include_preview: bool = False,
 ) -> dict[str, Any]:
-    """Attach fill plan + digest when bootstrap placeholders remain (shared by session/progress/gate)."""
+    """Attach per-project digest; include fill plan when bootstrap placeholders remain."""
     if steering.get("bootstrap_complete") is not False:
-        return {}
+        return attach_steering_digest_fields(steering)
 
     from pathlib import Path as PathCls
 

lib/agent/roadmap/explain_gate.py

@@ -64,10 +64,11 @@ def build_explain_gate_payload(*, workspace: Optional[str] = None) -> dict[str,
         ),
     }
     report = payload.get("report") or ""
-    if inputs.get("bootstrap_complete") is False:
-        from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_bootstrap_steering_fields
+    from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_bootstrap_steering_fields
 
-        payload.update(attach_bootstrap_steering_fields(steering, tier="light"))
+    attached = attach_bootstrap_steering_fields(steering, tier="light")
+    payload.update(attached)
+    if inputs.get("bootstrap_complete") is False:
         remaining = (payload.get("project_steering_digest") or {}).get("bootstrap_remaining")
         suffix = (
             f"\nBootstrap fill: {remaining} template phrase(s) remain — "

lib/agent/roadmap/progress.py

@@ -190,6 +190,10 @@ def build_progress_snapshot(*, workspace: Optional[str] = None) -> dict[str, Any
         from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_bootstrap_steering_fields
 
         payload.update(attach_bootstrap_steering_fields(steering, tier="light"))
+    else:
+        from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_steering_digest_fields
+
+        payload.update(attach_steering_digest_fields(steering))
     return payload
 
 

lib/agent/roadmap/project_fingerprint.py

@@ -103,13 +103,27 @@ def _fingerprint_cache_token(root: Path) -> float:
         "pnpm-workspace.yaml",
         "turbo.json",
         "SECURITY.md",
+        "compose.yml",
+        ".pre-commit-config.yaml",
     ):
         path = root / rel
         if path.is_file():
             try:
                 token = max(token, path.stat().st_mtime)
             except OSError:
                 continue
+    wf_dir = root / ".github" / "workflows"
+    if wf_dir.is_dir():
+        for path in wf_dir.glob("*.yml"):
+            try:
+                token = max(token, path.stat().st_mtime)
+            except OSError:
+                continue
+        for path in wf_dir.glob("*.yaml"):
+            try:
+                token = max(token, path.stat().st_mtime)
+            except OSError:
+                continue
     return token
 
 
@@ -460,6 +474,19 @@ def _compose_services(root: Path) -> list[str]:
     return []
 
 
+def _ci_workflow_names(root: Path) -> list[str]:
+    wf_dir = root / ".github" / "workflows"
+    if not wf_dir.is_dir():
+        return []
+    names: list[str] = []
+    for path in sorted(list(wf_dir.glob("*.yml")) + list(wf_dir.glob("*.yaml"))):
+        if path.stem not in names:
+            names.append(path.stem)
+        if len(names) >= 6:
+            break
+    return names
+
+
 def _governance_files(root: Path) -> list[str]:
     found: list[str] = []
     for rel in ("SECURITY.md", "CODE_OF_CONDUCT.md", ".editorconfig", "CHANGELOG.md"):
@@ -637,6 +664,8 @@ def _build_project_fingerprint(root: Path) -> dict[str, Any]:
     compose_services = _compose_services(root)
     governance_files = _governance_files(root)
     workspace_packages = _workspace_packages(root)
+    ci_workflow_names = _ci_workflow_names(root)
+    has_pre_commit = (root / ".pre-commit-config.yaml").is_file()
     has_codeowners = (root / ".github" / "CODEOWNERS").is_file() or (root / "CODEOWNERS").is_file()
     verification_commands = _verification_commands(
         root,
@@ -719,6 +748,8 @@ def _build_project_fingerprint(root: Path) -> dict[str, Any]:
         "compose_services": compose_services or None,
         "governance_files": governance_files or None,
         "workspace_packages": workspace_packages or None,
+        "ci_workflow_names": ci_workflow_names or None,
+        "has_pre_commit": has_pre_commit,
         "has_backstage_catalog": has_backstage,
         "catalog_name": catalog_meta.get("catalog_name"),
         "catalog_description": catalog_meta.get("catalog_description"),

lib/agent/roadmap/roadmap_checkpoint.py

@@ -431,6 +431,11 @@ def validate_roadmap(*, workspace: Optional[str] = None) -> dict[str, Any]:
             evidence=evidence,
             bootstrap_inc=True,
         )
+    elif validation.valid:
+        from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_steering_digest_fields
+        from plugins.dietcode.lib.agent.roadmap.steering_context import build_steering_context
+
+        payload.update(attach_steering_digest_fields(build_steering_context(workspace=root)))
     return clarity_envelope(payload, phase_info=phase_info)
 
 

lib/agent/roadmap/session.py

@@ -84,6 +84,10 @@ def session_brief(*, workspace: Optional[str] = None) -> dict[str, Any] | None:
             from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_bootstrap_steering_fields
 
             result.update(attach_bootstrap_steering_fields(steering, tier="light"))
+        else:
+            from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_steering_digest_fields
+
+            result.update(attach_steering_digest_fields(steering))
         return result
     except Exception as exc:
         return {"enabled": True, "success": False, "error": str(exc)}

lib/agent/roadmap/steering_context.py

@@ -173,6 +173,8 @@ def build_steering_context(*, workspace: Optional[str] = None) -> dict[str, Any]
     "compose_services",
     "governance_files",
     "workspace_packages",
+    "ci_workflow_names",
+    "has_pre_commit",
     "has_backstage_catalog",
     "catalog_name",
     "catalog_description",
@@ -199,4 +201,8 @@ def enrich_payload_with_steering(
         from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_bootstrap_steering_fields
 
         out.update(attach_bootstrap_steering_fields(steering, tier="light"))
+    elif "project_steering_digest" not in out:
+        from plugins.dietcode.lib.agent.roadmap.bootstrap_fill import attach_steering_digest_fields
+
+        out.update(attach_steering_digest_fields(steering))
     return out

lib/runtime/roadmap_hooks.py

@@ -215,6 +215,9 @@ def _post_tool_call(
                         "phase": payload.get("phase"),
                         "valid": payload.get("valid"),
                         "stale": (parsed.get("checkpoint_freshness") or {}).get("stale"),
+                        "steering_brief": parsed.get("steering_brief"),
+                        "project_archetype": parsed.get("project_archetype"),
+                        "verification_commands": (parsed.get("project_steering_digest") or {}).get("verification_commands"),
                     },
                     success=success,
                 )

scripts/roadmap_audit.py

@@ -222,6 +222,15 @@ def main() -> int:
         fp_sec = build_project_fingerprint(root)
         if "SECURITY.md" not in (fp_sec.get("governance_files") or []):
             failures.append("fingerprint should detect SECURITY.md governance file")
+        wf_dir = root / ".github" / "workflows"
+        wf_dir.mkdir(parents=True, exist_ok=True)
+        (wf_dir / "ci.yml").write_text("name: ci\n", encoding="utf-8")
+        from plugins.dietcode.lib.agent.roadmap.project_fingerprint import invalidate_fingerprint_cache
+
+        invalidate_fingerprint_cache(root)
+        fp_ci = build_project_fingerprint(root)
+        if "ci" not in (fp_ci.get("ci_workflow_names") or []):
+            failures.append("fingerprint should detect GitHub workflow names")
         if fp.get("project_archetype") not in {"project", "library", "application", "web-app", "cli-tool", "hermes-plugin", "monorepo"}:
             failures.append(f"unexpected project_archetype: {fp.get('project_archetype')}")
         roadmap_text = (root / "ROADMAP.md").read_text(encoding="utf-8")
@@ -359,6 +368,8 @@ def main() -> int:
         validated2 = validate_roadmap(workspace=str(root))
         if "bootstrap_fill_plan" not in validated2:
             failures.append("validate should include bootstrap_fill_plan when placeholders remain")
+        if not validated2.get("project_steering_digest"):
+            failures.append("validate missing project_steering_digest")
         if "recommended_next_action" not in validated2:
             failures.append("validate missing recommended_next_action")
         rec = validated2.get("recommended_next_action") or {}
@@ -446,8 +457,11 @@ def main() -> int:
             failures.append("explain_gate digest missing sample_fill_task")
 
         prog = build_progress_snapshot(workspace=str(root))
-        if "project_steering_digest" not in prog:
-            failures.append("progress missing project_steering_digest when bootstrap incomplete")
+        if not prog.get("project_steering_digest"):
+            failures.append("progress missing project_steering_digest")
+
+        if not (explain.get("project_steering_digest") or {}).get("steering_brief"):
+            failures.append("explain_gate missing project_steering_digest steering_brief")
 
         auto_ckpt = checkpoint_brief(workspace=str(root), context="apply autofill write")
         if "bootstrap_autofill_applied" not in auto_ckpt: