cc-agentic-framework 1.14.1

package/framework/modules/core/hooks/pre-write-quality.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Pre-Write Quality Hook
+# Validates file writes before they happen (advisory mode)
+#
+# This wrapper script invokes the compiled TypeScript hook.
+# Deploy to: .claude/hooks/pre-write-quality.sh
+
+# Find the framework CLI
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# Try to find the CLI in different locations
+if [ -f "$PROJECT_ROOT/framework/cli/dist/hooks/pre-write-quality.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/framework/cli/dist/hooks"
+elif [ -f "$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks/pre-write-quality.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks"
+else
+  # Hook not available, pass through
+  cat
+  exit 0
+fi
+
+# Run the TypeScript hook
+node "$CLI_HOOKS/pre-write-quality.js"

package/framework/modules/core/hooks/session-compact-context.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Session Compact Context Hook (SessionStart:compact)
+# Re-injects critical context after conversation compaction.
+# Advisory — never blocks.
+
+# Read stdin (Claude Code hook input)
+INPUT=$(cat)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+cd "$PROJECT_ROOT" || exit 0
+
+echo "CONTEXT RESTORE (post-compaction):"
+
+# Project identity
+if [[ -f "$PROJECT_ROOT/.agentic-framework.json" ]]; then
+  PROJECT_NAME=$(basename "$PROJECT_ROOT")
+  echo "  Project: $PROJECT_NAME"
+fi
+
+# Current branch
+if git rev-parse --is-inside-work-tree &>/dev/null; then
+  BRANCH=$(git branch --show-current 2>/dev/null)
+  echo "  Branch: $BRANCH"
+
+  # Show uncommitted changes count
+  CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+  if [[ "$CHANGES" -gt 0 ]]; then
+    echo "  Uncommitted changes: $CHANGES files"
+  fi
+fi
+
+# Remind about task list
+echo "  TIP: Check TaskList to recover task state after compaction."
+
+exit 0

package/framework/modules/core/hooks/session-end-reminder.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+# Session End Reminder Hook (SessionEnd)
+# Warns about uncommitted changes and suggests creating a PR.
+# Advisory — never blocks.
+
+# Read stdin (Claude Code hook input)
+INPUT=$(cat)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+cd "$PROJECT_ROOT" || exit 0
+
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  exit 0
+fi
+
+# Check for uncommitted changes
+CHANGES=$(git status --porcelain 2>/dev/null)
+if [[ -n "$CHANGES" ]]; then
+  COUNT=$(echo "$CHANGES" | wc -l | tr -d ' ')
+  echo "WARNING: $COUNT uncommitted file(s) detected."
+  echo "Consider committing your work before ending the session."
+fi
+
+# Check if on feature branch with unpushed commits
+BRANCH=$(git branch --show-current 2>/dev/null)
+if [[ "$BRANCH" != "main" && "$BRANCH" != "master" && -n "$BRANCH" ]]; then
+  UNPUSHED=$(git log --oneline "@{upstream}..HEAD" 2>/dev/null | wc -l | tr -d ' ')
+  if [[ "$UNPUSHED" -gt 0 ]]; then
+    echo "TIP: You have $UNPUSHED unpushed commit(s) on '$BRANCH'."
+    echo "Consider pushing and creating a PR: gh pr create"
+  fi
+fi
+
+exit 0

package/framework/modules/core/hooks/session-start-context.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# Session Start Context Hook (SessionStart:startup)
+# Outputs context reminders about available skills and conventions.
+# Advisory — never blocks.
+
+# Read stdin (Claude Code hook input)
+INPUT=$(cat)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+cd "$PROJECT_ROOT" || exit 0
+
+# Check for CLAUDE.md
+if [[ -f "$PROJECT_ROOT/CLAUDE.md" ]]; then
+  echo "CONTEXT: Project CLAUDE.md found — refer to it for project-specific instructions."
+fi
+
+# Check for .agentic-framework.json (framework project)
+if [[ -f "$PROJECT_ROOT/.agentic-framework.json" ]]; then
+  echo "CONTEXT: Agentic Framework project detected."
+  echo "  - Use /commit for git operations (invokes committing-code skill)"
+  echo "  - Use /verify for quality checks (invokes verifying-quality skill)"
+  echo "  - Run 'agentic-framework status' for framework health"
+fi
+
+# Show current branch
+if git rev-parse --is-inside-work-tree &>/dev/null; then
+  BRANCH=$(git branch --show-current 2>/dev/null)
+  echo "CONTEXT: Current branch: $BRANCH"
+fi
+
+exit 0

package/framework/modules/core/hooks/session-start-worktree.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Session Start Worktree Hook (SessionStart:startup)
+# Auto-creates git worktree when on main/master branch.
+# Advisory — outputs info, never blocks.
+
+# Read stdin (Claude Code hook input)
+INPUT=$(cat)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+cd "$PROJECT_ROOT" || exit 0
+
+# Only act in git repos
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  exit 0
+fi
+
+BRANCH=$(git branch --show-current 2>/dev/null)
+
+if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then
+  echo "WARNING: You are on the '$BRANCH' branch."
+  echo "Consider creating a worktree for your work:"
+  echo "  git worktree add ../$(basename "$PROJECT_ROOT")-feature feature-branch"
+  echo ""
+  echo "Or create a feature branch:"
+  echo "  git checkout -b feat/your-feature"
+fi
+
+exit 0

package/framework/modules/core/hooks/skill-reminder.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Skill Reminder Hook
+# Reminds agents about available on-demand skills when contextual cues match (advisory mode)
+#
+# This wrapper script invokes the compiled TypeScript hook.
+# Deploy to: .claude/hooks/skill-reminder.sh
+
+# Find the framework CLI
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# Try to find the CLI in different locations
+if [ -f "$PROJECT_ROOT/framework/cli/dist/hooks/skill-reminder.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/framework/cli/dist/hooks"
+elif [ -f "$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks/skill-reminder.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks"
+else
+  # Hook not available, pass through
+  cat
+  exit 0
+fi
+
+# Run the TypeScript hook
+node "$CLI_HOOKS/skill-reminder.js"

package/framework/modules/core/hooks/stop-commit-check.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Stop Commit Check Hook (Stop)
+# Checks for uncommitted work before stopping.
+# Advisory — never blocks.
+
+# Read stdin (Claude Code hook input)
+INPUT=$(cat)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+cd "$PROJECT_ROOT" || exit 0
+
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  exit 0
+fi
+
+CHANGES=$(git status --porcelain 2>/dev/null)
+if [[ -n "$CHANGES" ]]; then
+  COUNT=$(echo "$CHANGES" | wc -l | tr -d ' ')
+  echo "REMINDER: $COUNT uncommitted file(s). Consider committing before stopping."
+fi
+
+exit 0

package/framework/modules/core/hooks/stop-pr-suggest.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# Stop PR Suggest Hook (Stop)
+# Suggests creating a PR if commits exist on a feature branch.
+# Advisory — never blocks.
+
+# Read stdin (Claude Code hook input)
+INPUT=$(cat)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+cd "$PROJECT_ROOT" || exit 0
+
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  exit 0
+fi
+
+BRANCH=$(git branch --show-current 2>/dev/null)
+
+# Only suggest PR for feature branches
+if [[ "$BRANCH" == "main" || "$BRANCH" == "master" || -z "$BRANCH" ]]; then
+  exit 0
+fi
+
+# Check for unpushed commits
+UNPUSHED=$(git log --oneline "@{upstream}..HEAD" 2>/dev/null | wc -l | tr -d ' ')
+
+if [[ "$UNPUSHED" -gt 0 ]]; then
+  echo "TIP: Branch '$BRANCH' has $UNPUSHED unpushed commit(s)."
+  echo "  Push and create PR: git push -u origin $BRANCH && gh pr create"
+elif git log --oneline "origin/main..HEAD" 2>/dev/null | head -1 | grep -q .; then
+  # Branch has commits ahead of main but is already pushed
+  # Check if PR already exists
+  if command -v gh &>/dev/null; then
+    PR_URL=$(gh pr view --json url -q '.url' 2>/dev/null)
+    if [[ -z "$PR_URL" ]]; then
+      echo "TIP: Branch '$BRANCH' has commits not in main. Consider: gh pr create"
+    fi
+  fi
+fi
+
+exit 0

package/framework/modules/core/hooks/stop-quality-check.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Stop Quality Check Hook
+# Runs when an agent completes, providing a final quality summary (advisory mode)
+#
+# This wrapper script invokes the compiled TypeScript hook.
+# Deploy to: .claude/hooks/stop-quality-check.sh
+
+# Find the framework CLI
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# Try to find the CLI in different locations
+if [ -f "$PROJECT_ROOT/framework/cli/dist/hooks/stop-quality-check.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/framework/cli/dist/hooks"
+elif [ -f "$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks/stop-quality-check.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks"
+else
+  # Hook not available, pass through
+  cat
+  exit 0
+fi
+
+# Run the TypeScript hook
+node "$CLI_HOOKS/stop-quality-check.js"

package/framework/modules/core/hooks/subagent-context-loader.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Subagent Context Loader Hook
+# Auto-loads context files when subagents are started (advisory mode)
+#
+# This wrapper script invokes the compiled TypeScript hook.
+# Deploy to: .claude/hooks/subagent-context-loader.sh
+
+# Find the framework CLI
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# Try to find the CLI in different locations
+if [ -f "$PROJECT_ROOT/framework/cli/dist/hooks/subagent-context-loader.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/framework/cli/dist/hooks"
+elif [ -f "$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks/subagent-context-loader.js" ]; then
+  CLI_HOOKS="$PROJECT_ROOT/node_modules/agentic-framework/dist/hooks"
+else
+  # Hook not available, pass through
+  cat
+  exit 0
+fi
+
+# Run the TypeScript hook
+node "$CLI_HOOKS/subagent-context-loader.js"

package/framework/modules/core/module.json

@@ -0,0 +1,205 @@
+{
+  "$schema": "./registries/schemas/module.schema.json",
+  "id": "core",
+  "version": "1.9.0",
+  "name": "Framework Core",
+  "description": "Core framework infrastructure including framework management agents, shared skills, and essential utilities",
+  "provides": {
+    "agents": [
+      "ai-framework-manager",
+      "ai-framework-developer",
+      "ai-scout-backlog",
+      "ai-scout-codebase",
+      "ai-scout-knowledge"
+    ],
+    "skills": [
+      "committing-code",
+      "verifying-quality",
+      "validating-markdown",
+      "using-mcp",
+      "building-context",
+      "building-skills",
+      "using-framework",
+      "using-context",
+      "validating-links",
+      "building-framework",
+      "managing-versions",
+      "building-agents",
+      "gathering-intelligence"
+    ],
+    "capabilities": [
+      "framework-governance",
+      "git-workflow-management",
+      "jira-integration",
+      "jira-git-integration",
+      "jira-branch-workflow",
+      "quality-assurance",
+      "markdown-formatting",
+      "mcp-tool-usage",
+      "context-authoring",
+      "context-validation",
+      "skill-creation",
+      "framework-architecture-knowledge",
+      "context-loading-knowledge",
+      "link-validation",
+      "version-management",
+      "agent-design",
+      "framework-development",
+      "planning-phases",
+      "intelligence-gathering"
+    ],
+    "scripts": [],
+    "guards": [],
+    "cli-commands": [
+      {
+        "name": "validate --links",
+        "type": "validate",
+        "skill": "validating-links",
+        "description": "Validate markdown links in documentation"
+      },
+      {
+        "name": "validate --versions",
+        "type": "validate",
+        "skill": "managing-versions",
+        "description": "Validate version consistency across modules"
+      },
+      {
+        "name": "bump-version",
+        "type": "update",
+        "skill": "managing-versions",
+        "description": "Bump framework version"
+      },
+      "init",
+      "add",
+      "remove",
+      "list",
+      "info",
+      "validate",
+      "update",
+      "status",
+      "sync",
+      "routes",
+      {
+        "name": "agent list",
+        "type": "query",
+        "description": "List all SDK-enabled agents"
+      },
+      {
+        "name": "agent show",
+        "type": "query",
+        "description": "Show SDK definition for an agent"
+      },
+      {
+        "name": "agent run",
+        "type": "execute",
+        "description": "Run an agent with Claude Agent SDK"
+      }
+    ]
+  },
+  "requires": {},
+  "optional-dependencies": [],
+  "context": {
+    "business": [],
+    "technical": [],
+    "process": []
+  },
+  "entry-points": {
+    "hooks": {
+      "pre-commit": [
+        "agentic-framework routes check",
+        "agentic-framework validate --links",
+        "agentic-framework sync --skills --check",
+        "agentic-framework sync --agents --check",
+        "agentic-framework validate --versions"
+      ]
+    },
+    "claude-hooks": {
+      "SessionStart": [
+        {
+          "matcher": "startup",
+          "scripts": [
+            "session-start-worktree.sh",
+            "session-start-context.sh"
+          ]
+        },
+        {
+          "matcher": "compact",
+          "scripts": [
+            "session-compact-context.sh"
+          ]
+        }
+      ],
+      "SessionEnd": [
+        {
+          "matcher": ".*",
+          "scripts": [
+            "session-end-reminder.sh"
+          ]
+        }
+      ],
+      "PreToolUse": [
+        {
+          "matcher": "Write|Edit",
+          "scripts": [
+            "pre-write-quality.sh"
+          ]
+        },
+        {
+          "matcher": "Bash",
+          "scripts": [
+            "pre-commit-skill-reminder.sh",
+            "pre-bash-safety.sh"
+          ]
+        }
+      ],
+      "PostToolUse": [
+        {
+          "matcher": "Write|Edit",
+          "scripts": [
+            "post-write-validate.sh",
+            "post-write-format.sh"
+          ]
+        }
+      ],
+      "SubagentStart": [
+        {
+          "matcher": ".*",
+          "scripts": [
+            "subagent-context-loader.sh",
+            "skill-reminder.sh"
+          ]
+        }
+      ],
+      "Stop": [
+        {
+          "matcher": ".*",
+          "scripts": [
+            "stop-quality-check.sh",
+            "stop-commit-check.sh",
+            "stop-pr-suggest.sh"
+          ]
+        }
+      ],
+      "Notification": [
+        {
+          "matcher": "permission_prompt|idle_prompt",
+          "scripts": [
+            "notify.sh"
+          ]
+        }
+      ]
+    }
+  },
+  "metadata": {
+    "author": "Agentic Framework Team",
+    "license": "MIT",
+    "category": "core",
+    "keywords": [
+      "framework",
+      "infrastructure",
+      "agents",
+      "skills",
+      "discovery"
+    ]
+  }
+}