[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C0PRCYN20N3F1KQCEG9M5Q":3,"skill-same:01M7C0PRCYN20N3F1KQCEG9M5Q":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7C0PRCYN20N3F1KQCEG9M5Q","git-archaeology",null,"Layer 1 skill for mining git history for behavioral intelligence. Repository overview, commit message mining, PR\u002FMR description extraction, blame-based maintenance heat maps, issue tracker cross-referencing. Loaded by the analyzer agent during Layer 1.","zak-keown\u002Fmoe","zak-keown","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F320717241?v=4","01M7BZFXME0NW6TQX0H7AZM2KS","01M7BZFXN32VR0JN5AATRD53H4",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe-backstory\u002Fskills\u002Fgit-archaeology\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: git-archaeology\ndescription: Layer 1 skill for mining git history for behavioral intelligence. Repository overview, commit message mining, PR\u002FMR description extraction, blame-based maintenance heat maps, issue tracker cross-referencing. Loaded by the analyzer agent during Layer 1.\n---\n\n# Git Archaeology Methodology\n\nExtract behavioral intelligence from version control history. Commit messages, PR descriptions, blame annotations, and issue references encode design decisions, behavioral changes, and maintenance patterns that no other source captures.\n\n## When to Use This Mode\n\nGit archaeology activates when:\n- The target is a git repository (or has a `.git` directory)\n- The discovery inventory identifies a git repository with meaningful commit history\n- Other modes discover a git repository during analysis\n\nThis mode runs independently of all other intelligence sources. It requires only access to the git repository and optionally to a GitHub\u002FGitLab remote. All output is **RAW** (commit messages and PR descriptions may reference proprietary internals).\n\n## Why Git History Matters\n\nSource code tells you what the system does NOW. Git history tells you:\n- **What changed and why** -- commit messages encode intent that is invisible in the current code\n- **What broke and how it was fixed** -- fix commits reveal failure modes and edge cases\n- **What was deliberately removed** -- reverted features and deleted code reveal abandoned behaviors\n- **Where maintenance concentrates** -- frequently modified files signal complexity and instability\n- **What decisions were debated** -- PR descriptions capture design trade-offs that never appear in documentation\n\n## Phase 1: Repository Overview\n\n**Goal:** Establish the scope, age, and shape of the project.\n\n```bash\n# Commit count and date range\necho \"Total commits: $(git rev-list --count HEAD)\"\necho \"First commit: $(git log --reverse --format='%ai' | head -1)\"\necho \"Latest commit: $(git log -1 --format='%ai')\"\n\n# Contributors\ngit shortlog -sn --no-merges | head -20\n\n# Active branches\ngit branch -r --sort=-committerdate | head -20\n\n# Tags (releases)\ngit tag --sort=-version:refname | head -20\n\n# Commit frequency (commits per month, last 12 months)\nfor i in $(seq 0 11); do\n  month=$(date -d \"$i months ago\" +%Y-%m 2>\u002Fdev\u002Fnull || date -v-${i}m +%Y-%m)\n  count=$(git rev-list --count --after=\"${month}-01\" --before=\"${month}-31\" HEAD 2>\u002Fdev\u002Fnull || echo \"0\")\n  echo \"$month: $count\"\ndone\n\n# Top-level directory structure at HEAD\ngit ls-tree --name-only HEAD\n```\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Foverview.md`.\n\n## Phase 2: Commit Message Mining\n\n**Goal:** Extract behavioral claims from commit messages. Commit messages that describe features, fixes, and breaking changes encode behavioral contracts.\n\n### 2.1 Feature Commits\n\n```bash\n# Conventional commits: feat\ngit log --oneline --grep=\"^feat\" --no-merges | head -100\n\n# Keywords indicating new behavior\ngit log --oneline --grep=\"add\\|implement\\|introduce\\|support\\|enable\" -i --no-merges | head -100\n```\n\nFor each feature commit, extract:\n- What behavior was added (the claim)\n- When it was added (the commit date, for version context)\n- The commit SHA (for provenance)\n\n### 2.2 Fix Commits\n\n```bash\n# Conventional commits: fix\ngit log --oneline --grep=\"^fix\" --no-merges | head -100\n\n# Keywords indicating bug fixes\ngit log --oneline --grep=\"fix\\|bug\\|repair\\|correct\\|resolve\\|patch\" -i --no-merges | head -100\n```\n\nFix commits are especially valuable because they reveal:\n- A behavior that was WRONG (the bug)\n- A behavior that is now CORRECT (the fix)\n- Edge cases that the original implementation missed\n\n### 2.3 Breaking Change Commits\n\n```bash\n# Conventional commits: breaking\ngit log --oneline --grep=\"BREAKING\" --no-merges | head -50\n\n# Keywords indicating behavioral changes\ngit log --oneline --grep=\"breaking\\|deprecat\\|remov\\|migration\\|upgrade\" -i --no-merges | head -50\n```\n\nBreaking changes reveal behavioral contracts that were considered important enough to announce their violation.\n\n### 2.4 Detailed Message Extraction\n\nFor high-value commits (features, fixes, breaking changes), read the full commit message:\n\n```bash\n# Full message for a specific commit\ngit log -1 --format='%H%n%ai%n%an%n%n%B' \u003Ccommit-sha>\n```\n\nExtract behavioral claims from the message body. Many commit messages contain:\n- **Before\u002Fafter descriptions** -- explicit behavioral contract changes\n- **Issue references** -- links to detailed context\n- **Test descriptions** -- what was verified\n- **Migration instructions** -- how behavior shifted\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Fbehavioral-claims.md`.\n\n### Provenance for Commit-Derived Claims\n\n```markdown\n- The `--output csv` flag was added in v2.3\n  \u003C!-- cite: source=git-history, ref=abc1234, confidence=inferred, agent=git-archaeologist -->\n```\n\n## Phase 3: PR\u002FMR Description Mining\n\n**Goal:** Extract behavioral intelligence from pull request and merge request descriptions. PR descriptions often contain the richest behavioral context: motivation, design decisions, testing notes, and review discussions.\n\n### 3.1 GitHub PRs\n\n```bash\n# List merged PRs (most recent first)\ngh pr list --state merged --limit 100 --json number,title,body,mergedAt,labels\n\n# View a specific PR with full body and comments\ngh pr view \u003Cnumber> --json title,body,comments,reviews,labels,mergedAt\n\n# Search PRs by keyword\ngh pr list --state merged --search \"authentication\" --limit 20 --json number,title,body\n```\n\n### 3.2 GitLab MRs\n\nIf the remote is GitLab rather than GitHub:\n\n```bash\n# List merged MRs\nglab mr list --state merged --per-page 100\n\n# View a specific MR\nglab mr view \u003Cnumber>\n```\n\n### 3.3 What to Extract from PRs\u002FMRs\n\nFor each PR\u002FMR, extract:\n- **Motivation** -- why was this change made? What problem does it solve?\n- **Design decisions** -- what alternatives were considered? Why was this approach chosen?\n- **Testing notes** -- what was tested? How was it verified?\n- **Review comments** -- what concerns were raised? What was changed in response?\n- **Behavioral claims** -- explicit statements about what the code does or should do\n\nPR descriptions that contain phrases like \"this PR adds\", \"this fixes\", \"after this change\", \"the new behavior is\" are direct behavioral claims.\n\n### 3.4 Availability Check\n\nNot all repositories have accessible PR history. Check first:\n\n```bash\n# GitHub: check if gh CLI is authenticated and repo is accessible\ngh repo view --json name 2>\u002Fdev\u002Fnull && echo \"GitHub accessible\" || echo \"GitHub not accessible\"\n\n# Check if remote is GitHub or GitLab\ngit remote get-url origin\n```\n\nIf PR history is not accessible, document the gap and move on. Do not treat inaccessibility as failure.\n\n## Phase 4: Blame-Based Maintenance Heat Map\n\n**Goal:** Identify which parts of the codebase are actively maintained, recently modified, or fossilized. Maintenance patterns reveal where behavioral complexity concentrates.\n\n### 4.1 Recently Modified Files\n\n```bash\n# Files modified in the last 90 days, sorted by modification count\ngit log --since=\"90 days ago\" --name-only --no-merges --format=\"\" | sort | uniq -c | sort -rn | head -50\n```\n\n### 4.2 Most Frequently Modified Files (All Time)\n\n```bash\n# Files with the most commits\ngit log --name-only --no-merges --format=\"\" | sort | uniq -c | sort -rn | head -50\n```\n\n### 4.3 Fossilized Code\n\n```bash\n# Files not modified in over a year\ngit log --diff-filter=M --since=\"1 year ago\" --name-only --no-merges --format=\"\" | sort -u > \u002Ftmp\u002Frecently-modified.txt\ngit ls-files | while read f; do\n  grep -qx \"$f\" \u002Ftmp\u002Frecently-modified.txt || echo \"$f\"\ndone | head -100\n```\n\n### 4.4 Churn Analysis\n\n```bash\n# Files with the highest churn (lines added + removed) in last 6 months\ngit log --since=\"6 months ago\" --numstat --no-merges --format=\"\" | \\\n  awk '{adds[$3]+=$1; dels[$3]+=$2} END {for(f in adds) print adds[f]+dels[f], adds[f], dels[f], f}' | \\\n  sort -rn | head -30\n```\n\n### 4.5 Interpreting the Heat Map\n\n| Pattern | Signal |\n|---------|--------|\n| High recent churn, many contributors | Active development, likely unstable behavior |\n| High recent churn, single contributor | Focused refactoring or feature work |\n| No modifications in 1+ year | Fossilized: either stable or abandoned |\n| Frequent modifications to test files | Behavioral contracts actively evolving |\n| Config files frequently modified | Deployment or environment complexity |\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Fmaintenance-heatmap.md`.\n\n## Phase 5: Issue Tracker Cross-Reference\n\n**Goal:** Extract issue references from commits and fetch the referenced issues for behavioral context.\n\n### 5.1 Extract Issue References\n\n```bash\n# Find commits that reference issues (common patterns: #123, GH-123, JIRA-123)\ngit log --oneline --no-merges --format=\"%H %s\" | grep -oE '#[0-9]+|[A-Z]+-[0-9]+' | sort | uniq -c | sort -rn | head -50\n\n# Full commit messages that reference issues\ngit log --no-merges --grep='#[0-9]\\+' --format=\"%H %ai %s\" | head -50\n```\n\n### 5.2 Fetch Referenced Issues (GitHub)\n\n```bash\n# Fetch a specific issue\ngh issue view \u003Cnumber> --json title,body,comments,labels,state\n\n# List issues with behavioral labels\ngh issue list --label \"bug\" --state all --limit 50 --json number,title,body,state\ngh issue list --label \"enhancement\" --state all --limit 50 --json number,title,body,state\n```\n\n### 5.3 What to Extract from Issues\n\nIssues provide behavioral context that commits alone cannot:\n- **Bug reports** -- describe expected vs. actual behavior (behavioral contract violations)\n- **Feature requests** -- describe desired behavior (behavioral requirements)\n- **Discussion threads** -- capture design decisions and trade-offs\n- **Reproduction steps** -- equivalent to test vectors\n\n### 5.4 Availability Check\n\nIssue tracker access depends on the hosting platform and repository visibility. If the issue tracker is not accessible, document the gap. Extract what you can from commit message references alone.\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Fissue-references.md`.\n\n## Provenance Rules\n\n### Source Type\n\nAll claims from git history analysis use `source=git-history`:\n\n```markdown\n- The retry logic was added after users reported timeout failures on slow connections\n  \u003C!-- cite: source=git-history, ref=abc1234, confidence=inferred, agent=git-archaeologist -->\n```\n\n### Confidence Levels\n\n- **confirmed** -- the commit message or PR description explicitly states the behavioral claim, AND a second source (e.g., a linked issue or test change) corroborates it\n- **inferred** -- the commit message or PR description directly states or strongly implies the behavioral claim from a single source\n- **assumed** -- the behavioral claim is derived from commit patterns, file names, or structural reasoning rather than explicit statements\n\n### Cite As You Go\n\nEvery behavioral claim gets an inline citation immediately after the claim. The `ref` field should be the commit SHA (short form is acceptable). For PR-derived claims, use `ref=PR-\u003Cnumber>`.\n\n## Output Structure\n\n```\nworkspace\u002Fraw\u002Fproject-history\u002F\n    overview.md                # Repository overview: age, size, contributors, structure\n    behavioral-claims.md       # Behavioral claims extracted from commit messages\n    maintenance-heatmap.md     # File modification patterns and churn analysis\n    issue-references.md        # Issue cross-references and extracted behavioral context\n```\n\n## Rules\n\n1. **Git history is RAW** -- commit messages and PR descriptions may contain proprietary information. All output goes to `workspace\u002Fraw\u002F`.\n2. **Recency matters** -- recent commits are more likely to describe current behavior. Flag the date of every commit-derived claim.\n3. **Commit messages are claims, not facts** -- a commit that says \"fix authentication bug\" does not prove the fix is correct. It is an `inferred` claim until corroborated by another source.\n4. **Absence of history is not absence of behavior** -- a feature with no commit history may predate the repository or have been imported wholesale.\n5. **Do not read source code diffs** -- this is git ARCHAEOLOGY, not source analysis. Extract behavioral claims from messages, descriptions, and patterns. Source code analysis is a separate mode.\n6. **Document what is inaccessible** -- if PR history, issue trackers, or remote repositories are not reachable, document the gap explicitly. Partial results are valuable.\n7. **Cite as you go** -- every behavioral claim gets an inline `\u003C!-- cite: -->` comment immediately after the claim. Never defer citation to a later step.\n","# Git Archaeology Methodology\n\nExtract behavioral intelligence from version control history. Commit messages, PR descriptions, blame annotations, and issue references encode design decisions, behavioral changes, and maintenance patterns that no other source captures.\n\n## When to Use This Mode\n\nGit archaeology activates when:\n- The target is a git repository (or has a `.git` directory)\n- The discovery inventory identifies a git repository with meaningful commit history\n- Other modes discover a git repository during analysis\n\nThis mode runs independently of all other intelligence sources. It requires only access to the git repository and optionally to a GitHub\u002FGitLab remote. All output is **RAW** (commit messages and PR descriptions may reference proprietary internals).\n\n## Why Git History Matters\n\nSource code tells you what the system does NOW. Git history tells you:\n- **What changed and why** -- commit messages encode intent that is invisible in the current code\n- **What broke and how it was fixed** -- fix commits reveal failure modes and edge cases\n- **What was deliberately removed** -- reverted features and deleted code reveal abandoned behaviors\n- **Where maintenance concentrates** -- frequently modified files signal complexity and instability\n- **What decisions were debated** -- PR descriptions capture design trade-offs that never appear in documentation\n\n## Phase 1: Repository Overview\n\n**Goal:** Establish the scope, age, and shape of the project.\n\n```bash\n# Commit count and date range\necho \"Total commits: $(git rev-list --count HEAD)\"\necho \"First commit: $(git log --reverse --format='%ai' | head -1)\"\necho \"Latest commit: $(git log -1 --format='%ai')\"\n\n# Contributors\ngit shortlog -sn --no-merges | head -20\n\n# Active branches\ngit branch -r --sort=-committerdate | head -20\n\n# Tags (releases)\ngit tag --sort=-version:refname | head -20\n\n# Commit frequency (commits per month, last 12 months)\nfor i in $(seq 0 11); do\n  month=$(date -d \"$i months ago\" +%Y-%m 2>\u002Fdev\u002Fnull || date -v-${i}m +%Y-%m)\n  count=$(git rev-list --count --after=\"${month}-01\" --before=\"${month}-31\" HEAD 2>\u002Fdev\u002Fnull || echo \"0\")\n  echo \"$month: $count\"\ndone\n\n# Top-level directory structure at HEAD\ngit ls-tree --name-only HEAD\n```\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Foverview.md`.\n\n## Phase 2: Commit Message Mining\n\n**Goal:** Extract behavioral claims from commit messages. Commit messages that describe features, fixes, and breaking changes encode behavioral contracts.\n\n### 2.1 Feature Commits\n\n```bash\n# Conventional commits: feat\ngit log --oneline --grep=\"^feat\" --no-merges | head -100\n\n# Keywords indicating new behavior\ngit log --oneline --grep=\"add\\|implement\\|introduce\\|support\\|enable\" -i --no-merges | head -100\n```\n\nFor each feature commit, extract:\n- What behavior was added (the claim)\n- When it was added (the commit date, for version context)\n- The commit SHA (for provenance)\n\n### 2.2 Fix Commits\n\n```bash\n# Conventional commits: fix\ngit log --oneline --grep=\"^fix\" --no-merges | head -100\n\n# Keywords indicating bug fixes\ngit log --oneline --grep=\"fix\\|bug\\|repair\\|correct\\|resolve\\|patch\" -i --no-merges | head -100\n```\n\nFix commits are especially valuable because they reveal:\n- A behavior that was WRONG (the bug)\n- A behavior that is now CORRECT (the fix)\n- Edge cases that the original implementation missed\n\n### 2.3 Breaking Change Commits\n\n```bash\n# Conventional commits: breaking\ngit log --oneline --grep=\"BREAKING\" --no-merges | head -50\n\n# Keywords indicating behavioral changes\ngit log --oneline --grep=\"breaking\\|deprecat\\|remov\\|migration\\|upgrade\" -i --no-merges | head -50\n```\n\nBreaking changes reveal behavioral contracts that were considered important enough to announce their violation.\n\n### 2.4 Detailed Message Extraction\n\nFor high-value commits (features, fixes, breaking changes), read the full commit message:\n\n```bash\n# Full message for a specific commit\ngit log -1 --format='%H%n%ai%n%an%n%n%B' \u003Ccommit-sha>\n```\n\nExtract behavioral claims from the message body. Many commit messages contain:\n- **Before\u002Fafter descriptions** -- explicit behavioral contract changes\n- **Issue references** -- links to detailed context\n- **Test descriptions** -- what was verified\n- **Migration instructions** -- how behavior shifted\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Fbehavioral-claims.md`.\n\n### Provenance for Commit-Derived Claims\n\n```markdown\n- The `--output csv` flag was added in v2.3\n  \u003C!-- cite: source=git-history, ref=abc1234, confidence=inferred, agent=git-archaeologist -->\n```\n\n## Phase 3: PR\u002FMR Description Mining\n\n**Goal:** Extract behavioral intelligence from pull request and merge request descriptions. PR descriptions often contain the richest behavioral context: motivation, design decisions, testing notes, and review discussions.\n\n### 3.1 GitHub PRs\n\n```bash\n# List merged PRs (most recent first)\ngh pr list --state merged --limit 100 --json number,title,body,mergedAt,labels\n\n# View a specific PR with full body and comments\ngh pr view \u003Cnumber> --json title,body,comments,reviews,labels,mergedAt\n\n# Search PRs by keyword\ngh pr list --state merged --search \"authentication\" --limit 20 --json number,title,body\n```\n\n### 3.2 GitLab MRs\n\nIf the remote is GitLab rather than GitHub:\n\n```bash\n# List merged MRs\nglab mr list --state merged --per-page 100\n\n# View a specific MR\nglab mr view \u003Cnumber>\n```\n\n### 3.3 What to Extract from PRs\u002FMRs\n\nFor each PR\u002FMR, extract:\n- **Motivation** -- why was this change made? What problem does it solve?\n- **Design decisions** -- what alternatives were considered? Why was this approach chosen?\n- **Testing notes** -- what was tested? How was it verified?\n- **Review comments** -- what concerns were raised? What was changed in response?\n- **Behavioral claims** -- explicit statements about what the code does or should do\n\nPR descriptions that contain phrases like \"this PR adds\", \"this fixes\", \"after this change\", \"the new behavior is\" are direct behavioral claims.\n\n### 3.4 Availability Check\n\nNot all repositories have accessible PR history. Check first:\n\n```bash\n# GitHub: check if gh CLI is authenticated and repo is accessible\ngh repo view --json name 2>\u002Fdev\u002Fnull && echo \"GitHub accessible\" || echo \"GitHub not accessible\"\n\n# Check if remote is GitHub or GitLab\ngit remote get-url origin\n```\n\nIf PR history is not accessible, document the gap and move on. Do not treat inaccessibility as failure.\n\n## Phase 4: Blame-Based Maintenance Heat Map\n\n**Goal:** Identify which parts of the codebase are actively maintained, recently modified, or fossilized. Maintenance patterns reveal where behavioral complexity concentrates.\n\n### 4.1 Recently Modified Files\n\n```bash\n# Files modified in the last 90 days, sorted by modification count\ngit log --since=\"90 days ago\" --name-only --no-merges --format=\"\" | sort | uniq -c | sort -rn | head -50\n```\n\n### 4.2 Most Frequently Modified Files (All Time)\n\n```bash\n# Files with the most commits\ngit log --name-only --no-merges --format=\"\" | sort | uniq -c | sort -rn | head -50\n```\n\n### 4.3 Fossilized Code\n\n```bash\n# Files not modified in over a year\ngit log --diff-filter=M --since=\"1 year ago\" --name-only --no-merges --format=\"\" | sort -u > \u002Ftmp\u002Frecently-modified.txt\ngit ls-files | while read f; do\n  grep -qx \"$f\" \u002Ftmp\u002Frecently-modified.txt || echo \"$f\"\ndone | head -100\n```\n\n### 4.4 Churn Analysis\n\n```bash\n# Files with the highest churn (lines added + removed) in last 6 months\ngit log --since=\"6 months ago\" --numstat --no-merges --format=\"\" | \\\n  awk '{adds[$3]+=$1; dels[$3]+=$2} END {for(f in adds) print adds[f]+dels[f], adds[f], dels[f], f}' | \\\n  sort -rn | head -30\n```\n\n### 4.5 Interpreting the Heat Map\n\n| Pattern | Signal |\n|---------|--------|\n| High recent churn, many contributors | Active development, likely unstable behavior |\n| High recent churn, single contributor | Focused refactoring or feature work |\n| No modifications in 1+ year | Fossilized: either stable or abandoned |\n| Frequent modifications to test files | Behavioral contracts actively evolving |\n| Config files frequently modified | Deployment or environment complexity |\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Fmaintenance-heatmap.md`.\n\n## Phase 5: Issue Tracker Cross-Reference\n\n**Goal:** Extract issue references from commits and fetch the referenced issues for behavioral context.\n\n### 5.1 Extract Issue References\n\n```bash\n# Find commits that reference issues (common patterns: #123, GH-123, JIRA-123)\ngit log --oneline --no-merges --format=\"%H %s\" | grep -oE '#[0-9]+|[A-Z]+-[0-9]+' | sort | uniq -c | sort -rn | head -50\n\n# Full commit messages that reference issues\ngit log --no-merges --grep='#[0-9]\\+' --format=\"%H %ai %s\" | head -50\n```\n\n### 5.2 Fetch Referenced Issues (GitHub)\n\n```bash\n# Fetch a specific issue\ngh issue view \u003Cnumber> --json title,body,comments,labels,state\n\n# List issues with behavioral labels\ngh issue list --label \"bug\" --state all --limit 50 --json number,title,body,state\ngh issue list --label \"enhancement\" --state all --limit 50 --json number,title,body,state\n```\n\n### 5.3 What to Extract from Issues\n\nIssues provide behavioral context that commits alone cannot:\n- **Bug reports** -- describe expected vs. actual behavior (behavioral contract violations)\n- **Feature requests** -- describe desired behavior (behavioral requirements)\n- **Discussion threads** -- capture design decisions and trade-offs\n- **Reproduction steps** -- equivalent to test vectors\n\n### 5.4 Availability Check\n\nIssue tracker access depends on the hosting platform and repository visibility. If the issue tracker is not accessible, document the gap. Extract what you can from commit message references alone.\n\nWrite to `workspace\u002Fraw\u002Fproject-history\u002Fissue-references.md`.\n\n## Provenance Rules\n\n### Source Type\n\nAll claims from git history analysis use `source=git-history`:\n\n```markdown\n- The retry logic was added after users reported timeout failures on slow connections\n  \u003C!-- cite: source=git-history, ref=abc1234, confidence=inferred, agent=git-archaeologist -->\n```\n\n### Confidence Levels\n\n- **confirmed** -- the commit message or PR description explicitly states the behavioral claim, AND a second source (e.g., a linked issue or test change) corroborates it\n- **inferred** -- the commit message or PR description directly states or strongly implies the behavioral claim from a single source\n- **assumed** -- the behavioral claim is derived from commit patterns, file names, or structural reasoning rather than explicit statements\n\n### Cite As You Go\n\nEvery behavioral claim gets an inline citation immediately after the claim. The `ref` field should be the commit SHA (short form is acceptable). For PR-derived claims, use `ref=PR-\u003Cnumber>`.\n\n## Output Structure\n\n```\nworkspace\u002Fraw\u002Fproject-history\u002F\n    overview.md                # Repository overview: age, size, contributors, structure\n    behavioral-claims.md       # Behavioral claims extracted from commit messages\n    maintenance-heatmap.md     # File modification patterns and churn analysis\n    issue-references.md        # Issue cross-references and extracted behavioral context\n```\n\n## Rules\n\n1. **Git history is RAW** -- commit messages and PR descriptions may contain proprietary information. All output goes to `workspace\u002Fraw\u002F`.\n2. **Recency matters** -- recent commits are more likely to describe current behavior. Flag the date of every commit-derived claim.\n3. **Commit messages are claims, not facts** -- a commit that says \"fix authentication bug\" does not prove the fix is correct. It is an `inferred` claim until corroborated by another source.\n4. **Absence of history is not absence of behavior** -- a feature with no commit history may predate the repository or have been imported wholesale.\n5. **Do not read source code diffs** -- this is git ARCHAEOLOGY, not source analysis. Extract behavioral claims from messages, descriptions, and patterns. Source code analysis is a separate mode.\n6. **Document what is inaccessible** -- if PR history, issue trackers, or remote repositories are not reachable, document the gap explicitly. Partial results are valuable.\n7. **Cite as you go** -- every behavioral claim gets an inline `\u003C!-- cite: -->` comment immediately after the claim. Never defer citation to a later step.\n",{"name":5,"description":7},"main","728894f3f85fbd4e788f015ddfd72bb6155d5dd5","plugins\u002Fmoe-backstory\u002Fskills\u002Fgit-archaeology",1,"https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe","https:\u002F\u002Fgithub.com\u002Fzak-keown","2026-09-05 06:29:06",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add zak-keown\u002Fmoe --skill git-archaeology",{"tool":36,"command":37},"bunx","bunx skills add zak-keown\u002Fmoe --skill git-archaeology",{"tool":39,"command":40},"pnpm","pnpm dlx skills add zak-keown\u002Fmoe --skill git-archaeology","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe-backstory\u002Fskills\u002Fgit-archaeology\u002FSKILL.md",true,[],[45,52,59,66,73,80],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":18},"01M7C1Z5362Y8NVRZ69HWP0ZD0","write-skill","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe\u002Fskills\u002Fwrite-skill\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":18},"01M7C1YZ9966WK9R6ZRPCGWF3G","write-plan","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe\u002Fskills\u002Fwrite-plan\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M7C1YMR4SJD7BPBBPXZCVGVH","write-clearly","Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional.","https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe\u002Fskills\u002Fwrite-clearly\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":18},"01M7C1YH9805YSM0N20VQAVSXF","windows-vm","Create, manage, or connect to a headless Windows 11 VM running in Docker with SSH access. Use when the user wants to spin up, stop, restart, or SSH into a Windows VM.","https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe\u002Fskills\u002Fwindows-vm\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7C1YD87SCNEJ2C9B8HFR2NQ","verify-completion","Use when about to claim work is complete, fixed, or passing, before committing or creating MRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe\u002Fskills\u002Fverify-completion\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":18},"01M7C1YARDEHT0TJ9BRG30ZCF4","using-moe","Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions","https:\u002F\u002Fgithub.com\u002Fzak-keown\u002Fmoe\u002Fblob\u002Fmain\u002Fplugins\u002Fmoe\u002Fskills\u002Fusing-moe\u002FSKILL.md",[],[]]