Skip to content

dirien/yet-another-agent-harness / .claude/skills/agent-rules

agent-rules

Flagged

Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, standardizing agent documentation, or when anyone mentions AGENTS.md, agent rules, project onboarding, or codebase documentation for AI agents.

FileKindSize
AGENTS.mdmarkdown3.9 KB
CLAUDE.mdmarkdown9 B
SKILL.mdskill md4.5 KB
assets/example-workflows/validate-agents.ymlconfig2.7 KB
assets/root-thin.mdmarkdown5.7 KB
assets/root-verbose.mdmarkdown5.5 KB
assets/scoped/backend-go.mdmarkdown3.6 KB
assets/scoped/backend-php.mdmarkdown3.0 KB
assets/scoped/backend-python.mdmarkdown2.6 KB
assets/scoped/backend-typescript.mdmarkdown2.8 KB
assets/scoped/claude-code-skill.mdmarkdown3.4 KB
assets/scoped/cli.mdmarkdown2.7 KB
assets/scoped/concourse.mdmarkdown5.2 KB
assets/scoped/ddev.mdmarkdown2.4 KB
assets/scoped/docker.mdmarkdown5.3 KB
assets/scoped/documentation.mdmarkdown3.5 KB
assets/scoped/examples.mdmarkdown3.4 KB
assets/scoped/frontend-typescript.mdmarkdown2.7 KB
assets/scoped/github-actions.mdmarkdown5.2 KB
assets/scoped/gitlab-ci.mdmarkdown4.6 KB
assets/scoped/oro-bundle.mdmarkdown6.5 KB
assets/scoped/oro-project.mdmarkdown5.5 KB
assets/scoped/python-modern.mdmarkdown6.1 KB
assets/scoped/resources.mdmarkdown3.5 KB
assets/scoped/skill-repo.mdmarkdown5.4 KB
assets/scoped/symfony.mdmarkdown5.3 KB
assets/scoped/testing.mdmarkdown3.0 KB
assets/scoped/typo3-docs.mdmarkdown3.6 KB
assets/scoped/typo3-extension.mdmarkdown5.1 KB
assets/scoped/typo3-project.mdmarkdown4.7 KB
assets/scoped/typo3-testing.mdmarkdown3.0 KB
checkpoints.yamlconfig9.0 KB
evals/evals.jsonconfig20.7 KB
references/ai-contribution-guidelines.mdmarkdown2.5 KB
references/ai-tool-compatibility.mdmarkdown7.9 KB
references/analysis.mdmarkdown10.8 KB
references/directory-coverage.mdmarkdown2.4 KB
references/examples/coding-agent-cli/AGENTS.mdmarkdown2.5 KB
references/examples/coding-agent-cli/go.modmanifest45 B
references/examples/coding-agent-cli/scripts-AGENTS.mdmarkdown10.1 KB
references/examples/express-api-ts/.env.exampleother232 B
references/examples/express-api-ts/AGENTS.mdmarkdown3.1 KB
references/examples/express-api-ts/package.jsonmanifest757 B
references/examples/express-api-ts/pnpm-lock.yamlmanifest101 B
references/examples/express-api-ts/src/AGENTS.mdmarkdown3.1 KB
references/examples/express-api-ts/src/config.tsscript917 B
references/examples/express-api-ts/src/controllers/userController.tsscript2.1 KB
references/examples/express-api-ts/src/index.tsscript671 B
references/examples/express-api-ts/src/middleware/errorHandler.tsscript1.0 KB
references/examples/express-api-ts/src/middleware/requestLogger.tsscript471 B
references/examples/express-api-ts/src/routes/health.tsscript428 B
references/examples/express-api-ts/src/routes/users.tsscript397 B
references/examples/express-api-ts/src/utils/errors.tsscript1.2 KB
references/examples/express-api-ts/src/utils/logger.tsscript441 B
references/examples/express-api-ts/tsconfig.jsonconfig630 B
references/examples/fastapi-app/.env.exampleother348 B
references/examples/fastapi-app/AGENTS.mdmarkdown3.2 KB
references/examples/fastapi-app/pyproject.tomlmanifest1.8 KB
references/examples/fastapi-app/src/AGENTS.mdmarkdown2.9 KB
references/examples/fastapi-app/src/__init__.pyscript58 B
references/examples/fastapi-app/src/config.pyscript1.1 KB
references/examples/fastapi-app/src/main.pyscript1.7 KB
references/examples/fastapi-app/src/models/__init__.pyscript278 B
references/examples/fastapi-app/src/models/item.pyscript1.0 KB
references/examples/fastapi-app/src/models/user.pyscript922 B
references/examples/fastapi-app/src/routes/__init__.pyscript110 B
references/examples/fastapi-app/src/routes/health.pyscript470 B
references/examples/fastapi-app/src/routes/items.pyscript1.9 KB
references/examples/fastapi-app/src/routes/users.pyscript1.7 KB
references/examples/fastapi-app/src/services/__init__.pyscript174 B
references/examples/fastapi-app/src/services/item_service.pyscript2.5 KB
references/examples/fastapi-app/src/services/user_service.pyscript2.1 KB
references/examples/fastapi-app/uv.lockmanifest136 B
references/examples/go-api-with-react-admin/.scopesother93 B
references/examples/go-api-with-react-admin/AGENTS.mdmarkdown3.0 KB
references/examples/go-api-with-react-admin/admin/package.jsonmanifest422 B
references/examples/go-api-with-react-admin/admin/src/App.tsxother101 B
references/examples/go-api-with-react-admin/cmd/api/main.goscript75 B
references/examples/go-api-with-react-admin/go.modmanifest31 B
references/examples/go-api-with-react-admin/main.goscript71 B
references/examples/go-with-internal-web-tsx/.scopesother102 B
references/examples/go-with-internal-web-tsx/AGENTS.mdmarkdown3.1 KB
references/examples/go-with-internal-web-tsx/go.modmanifest34 B
references/examples/go-with-internal-web-tsx/internal/web/AGENTS.mdmarkdown3.1 KB
references/examples/go-with-internal-web-tsx/internal/web/package.jsonmanifest328 B
references/examples/go-with-internal-web-tsx/internal/web/src/App.tsxother57 B
references/examples/go-with-internal-web-tsx/internal/web/src/Button.tsxother63 B
references/examples/go-with-internal-web-tsx/internal/web/src/Footer.tsxother63 B
references/examples/go-with-internal-web-tsx/internal/web/src/Header.tsxother63 B
references/examples/go-with-internal-web-tsx/internal/web/src/Sidebar.tsxother65 B
references/examples/go-with-internal-web-tsx/main.goscript85 B
references/examples/go-with-internal-web-tsx/package-lock.jsonmanifest0 B
references/examples/go-with-internal-web-tsx/package.jsonmanifest220 B
references/examples/ldap-selfservice/AGENTS.mdmarkdown2.5 KB
references/examples/ldap-selfservice/go.modmanifest45 B
references/examples/ldap-selfservice/internal-AGENTS.mdmarkdown10.0 KB
references/examples/ldap-selfservice/internal-web-AGENTS.mdmarkdown12.1 KB
references/examples/php-with-frontend/.scopesother89 B
references/examples/php-with-frontend/AGENTS.mdmarkdown3.1 KB
references/examples/php-with-frontend/composer.jsonconfig185 B
references/examples/php-with-frontend/package.jsonmanifest306 B
references/examples/php-with-frontend/pnpm-lock.yamlmanifest0 B
references/examples/php-with-frontend/src/Controller.phpscript41 B
references/examples/php-with-frontend/web/AGENTS.mdmarkdown3.1 KB
references/examples/php-with-frontend/web/package.jsonmanifest514 B
references/examples/php-with-frontend/web/src/App.tsxother63 B
references/examples/php-with-frontend/web/src/Button.tsxother215 B
references/examples/php-with-frontend/web/src/Footer.tsxother125 B
references/examples/php-with-frontend/web/src/Header.tsxother122 B
references/examples/php-with-frontend/web/src/main.tsxother68 B
references/examples/php-with-frontend/web/tsconfig.jsonconfig280 B
references/examples/pnpm-workspace/AGENTS.mdmarkdown2.6 KB
references/examples/pnpm-workspace/package.jsonmanifest105 B
references/examples/pnpm-workspace/packages/web/package.jsonmanifest187 B
references/examples/pnpm-workspace/packages/web/src/index.tsscript258 B
references/examples/pnpm-workspace/pnpm-lock.yamlmanifest920 B
references/examples/pnpm-workspace/pnpm-workspace.yamlconfig27 B
references/examples/simple-ldap-go/AGENTS.mdmarkdown2.5 KB
references/examples/simple-ldap-go/examples-AGENTS.mdmarkdown1.8 KB
references/examples/simple-ldap-go/go.modmanifest43 B
references/examples/t3x-rte-ckeditor-image/AGENTS.mdmarkdown2.5 KB
references/examples/t3x-rte-ckeditor-image/Classes-AGENTS.mdmarkdown12.0 KB
references/examples/t3x-rte-ckeditor-image/composer.jsonconfig174 B
references/feedback-memory-schema.mdmarkdown7.2 KB
references/git-hooks-setup.mdmarkdown2.4 KB
references/output-structure.mdmarkdown4.9 KB
references/scripts-guide.mdmarkdown4.9 KB
references/verification-guide.mdmarkdown5.5 KB
scripts/analyze-git-history.shexecutablescript9.8 KB
scripts/check-freshness.shexecutablescript6.3 KB
scripts/detect-golden-samples.shexecutablescript5.3 KB
scripts/detect-heuristics.shexecutablescript3.2 KB
scripts/detect-project.shexecutablescript19.3 KB
scripts/detect-scopes.shexecutablescript12.1 KB
scripts/detect-utilities.shexecutablescript4.3 KB
scripts/extract-adrs.shexecutablescript6.6 KB
scripts/extract-agent-configs.shexecutablescript9.2 KB
scripts/extract-architecture-rules.shexecutablescript19.9 KB
scripts/extract-ci-commands.shexecutablescript12.5 KB
scripts/extract-ci-rules.shexecutablescript15.4 KB
scripts/extract-commands.shexecutablescript11.0 KB
scripts/extract-documentation.shexecutablescript7.7 KB
scripts/extract-github-rulesets.shexecutablescript3.5 KB
scripts/extract-github-settings.shexecutablescript3.3 KB
scripts/extract-ide-settings.shexecutablescript7.0 KB
scripts/extract-platform-files.shexecutablescript7.9 KB
scripts/extract-quality-configs.shexecutablescript14.8 KB
scripts/generate-agents.shexecutablescript113.6 KB
scripts/generate-file-map.shexecutablescript4.4 KB
scripts/lib/config-root.shexecutablescript5.8 KB
scripts/lib/summary.shscript10.7 KB
scripts/lib/template.shexecutablescript13.1 KB
scripts/validate-structure.shexecutablescript8.6 KB
scripts/verify-commands.shexecutablescript22.0 KB
scripts/verify-content.shexecutablescript9.5 KB

scripts/analyze-git-history.sh

View on GitHub
#!/usr/bin/env bash
# Analyze git history for patterns (commit conventions, branching, releases)
set -euo pipefail

PROJECT_DIR="${1:-.}"
cd "$PROJECT_DIR"

# Check if we're in a git repository
if ! git rev-parse --git-dir > /dev/null 2>&1; then
    echo '{"error": "Not a git repository"}'
    exit 0
fi

SAMPLE_SIZE=100

# Helper to count grep matches (returns 0 if no matches instead of error)
count_matches() {
    local pattern="$1"
    local input="$2"
    local flags="${3:-}"
    local count
    # shellcheck disable=SC2086  # flags must be unquoted to work as separate arguments
    count=$(echo "$input" | grep $flags -cE "$pattern" 2>/dev/null) || count=0
    echo "$count"
}

# Analyze commit message conventions
analyze_commit_convention() {
    local commits
    commits=$(git log --oneline -"$SAMPLE_SIZE" --pretty=format:"%s" 2>/dev/null || echo "")

    if [ -z "$commits" ]; then
        echo '{"convention": "unknown", "confidence": 0}'
        return
    fi

    local total_commits
    total_commits=$(echo "$commits" | wc -l)

    # Count conventional commits (feat:, fix:, docs:, style:, refactor:, test:, chore:, etc.)
    local conventional_count
    conventional_count=$(count_matches '^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?(!)?:' "$commits")

    # Count [TAG] style commits
    local tag_count
    tag_count=$(count_matches '^\[.+\]' "$commits")

    # Count ticket reference commits (JIRA-123, #123, etc.)
    local ticket_count
    ticket_count=$(count_matches '([A-Z]+-[0-9]+|#[0-9]+)' "$commits" "-i")

    # Count emoji commits
    local emoji_count
    emoji_count=$(count_matches '^(✨|🐛|📝|🎨|♻️|🚀|✅|🔧|⬆️|🔒)' "$commits")

    # Determine convention
    local convention="freeform"
    local confidence=0

    local conventional_pct=$((conventional_count * 100 / total_commits))
    local tag_pct=$((tag_count * 100 / total_commits))
    local ticket_pct=$((ticket_count * 100 / total_commits))
    local emoji_pct=$((emoji_count * 100 / total_commits))

    if [ "$conventional_pct" -ge 50 ]; then
        convention="conventional-commits"
        confidence=$conventional_pct
    elif [ "$tag_pct" -ge 50 ]; then
        convention="tag-prefix"
        confidence=$tag_pct
    elif [ "$emoji_pct" -ge 30 ]; then
        convention="emoji"
        confidence=$emoji_pct
    elif [ "$ticket_pct" -ge 50 ]; then
        convention="ticket-reference"
        confidence=$ticket_pct
    fi

    # Extract common prefixes
    local prefixes=()
    if [ "$convention" = "conventional-commits" ]; then
        mapfile -t prefixes < <(echo "$commits" | grep -oE '^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)' | sort | uniq -c | sort -rn | head -5 | awk '{print $2}')
    elif [ "$convention" = "tag-prefix" ]; then
        mapfile -t prefixes < <(echo "$commits" | grep -oE '^\[[^\]]+\]' | sort | uniq -c | sort -rn | head -5 | awk '{print $2}')
    fi

    local prefixes_json="[]"
    [ ${#prefixes[@]} -gt 0 ] && prefixes_json=$(printf '%s\n' "${prefixes[@]}" | jq -R . | jq -s .)

    jq -n \
        --arg convention "$convention" \
        --arg confidence "$confidence" \
        --argjson prefixes "$prefixes_json" \
        --arg total "$total_commits" \
        --arg conventional "$conventional_count" \
        --arg tag "$tag_count" \
        --arg ticket "$ticket_count" \
        '{
            convention: $convention,
            confidence: ($confidence | tonumber),
            common_prefixes: $prefixes,
            stats: {
                total_analyzed: ($total | tonumber),
                conventional_commits: ($conventional | tonumber),
                tag_style: ($tag | tonumber),
                ticket_references: ($ticket | tonumber)
            }
        }'
}

# Analyze branch naming
analyze_branch_naming() {
    local branches
    branches=$(git branch -r 2>/dev/null | grep -v HEAD | sed 's/.*\///' | head -50 || echo "")

    if [ -z "$branches" ]; then
        echo '{"pattern": "unknown", "stats": {"total_branches": 0}}'
        return
    fi

    local total_branches
    total_branches=$(echo "$branches" | grep -c . || echo "0")

    if [ "$total_branches" -eq 0 ]; then
        echo '{"pattern": "unknown", "stats": {"total_branches": 0}}'
        return
    fi

    # Count different patterns
    local feature_count
    feature_count=$(count_matches '^feature[/-]' "$branches")

    local fix_count
    fix_count=$(count_matches '^(fix|bugfix|hotfix)[/-]' "$branches")

    local release_count
    release_count=$(count_matches '^release[/-]' "$branches")

    local ticket_count
    ticket_count=$(count_matches '[A-Z]+-[0-9]+' "$branches" "-i")

    # Determine pattern
    local pattern="freeform"
    local has_feature="false"
    local has_fix="false"

    [[ "$feature_count" -gt 2 ]] && has_feature="true"
    [[ "$fix_count" -gt 2 ]] && has_fix="true"

    if [[ "$has_feature" == "true" ]] || [[ "$has_fix" == "true" ]]; then
        pattern="gitflow-style"
    fi
    if [ "$total_branches" -gt 0 ] && [ "$ticket_count" -gt $((total_branches / 3)) ]; then
        pattern="ticket-based"
    fi

    jq -n \
        --arg pattern "$pattern" \
        --argjson has_feature "$has_feature" \
        --argjson has_fix "$has_fix" \
        --arg total "$total_branches" \
        --arg feature "$feature_count" \
        --arg fix "$fix_count" \
        --arg release "$release_count" \
        '{
            pattern: $pattern,
            uses_feature_branches: $has_feature,
            uses_fix_branches: $has_fix,
            stats: {
                total_branches: ($total | tonumber),
                feature_branches: ($feature | tonumber),
                fix_branches: ($fix | tonumber),
                release_branches: ($release | tonumber)
            }
        }'
}

# Analyze merge strategy
analyze_merge_strategy() {
    local merge_commits
    merge_commits=$(git log --oneline -"$SAMPLE_SIZE" --merges 2>/dev/null | wc -l || echo "0")

    local total_commits
    total_commits=$(git log --oneline -"$SAMPLE_SIZE" 2>/dev/null | wc -l || echo "0")

    if [ "$total_commits" -eq 0 ]; then
        echo '{"strategy": "unknown"}'
        return
    fi

    local merge_pct=$((merge_commits * 100 / total_commits))

    local strategy="unknown"
    if [ "$merge_pct" -lt 5 ]; then
        strategy="squash-and-merge"
    elif [ "$merge_pct" -gt 20 ]; then
        strategy="merge-commits"
    else
        strategy="mixed"
    fi

    # Check for squash patterns in commit messages
    local squash_patterns
    squash_patterns=$(git log --oneline -"$SAMPLE_SIZE" 2>/dev/null | grep -cE '\(#[0-9]+\)$' || echo "0")

    if [ "$squash_patterns" -gt $((total_commits / 3)) ]; then
        strategy="squash-and-merge"
    fi

    jq -n \
        --arg strategy "$strategy" \
        --arg merge_pct "$merge_pct" \
        --arg merge_commits "$merge_commits" \
        --arg total "$total_commits" \
        '{
            strategy: $strategy,
            merge_commit_percentage: ($merge_pct | tonumber),
            stats: {
                merge_commits: ($merge_commits | tonumber),
                total_commits: ($total | tonumber)
            }
        }'
}

# Analyze release tagging
analyze_releases() {
    local tags
    tags=$(git tag -l 2>/dev/null | tail -20 || echo "")

    if [ -z "$tags" ]; then
        echo '{"pattern": "none", "total_tags": 0}'
        return
    fi

    local total_tags
    total_tags=$(echo "$tags" | wc -l)

    # Check for semver pattern (v1.2.3 or 1.2.3)
    local semver_count
    semver_count=$(echo "$tags" | grep -cE '^v?[0-9]+\.[0-9]+\.[0-9]+' 2>/dev/null || echo "0")

    # Check for calver pattern (2024.01.15 or similar)
    local calver_count
    calver_count=$(echo "$tags" | grep -cE '^[0-9]{4}\.[0-9]{2}' 2>/dev/null || echo "0")

    local pattern="custom"
    if [ "$semver_count" -gt $((total_tags / 2)) ]; then
        pattern="semver"
    elif [ "$calver_count" -gt $((total_tags / 2)) ]; then
        pattern="calver"
    fi

    # Check for v prefix
    local has_v_prefix
    has_v_prefix=$([[ $(echo "$tags" | grep -cE '^v' || echo "0") -gt $((total_tags / 2)) ]] && echo "true" || echo "false")

    # Get latest tag
    local latest_tag
    latest_tag=$(git describe --tags --abbrev=0 2>/dev/null || echo "")

    jq -n \
        --arg pattern "$pattern" \
        --argjson has_v_prefix "$has_v_prefix" \
        --arg latest "$latest_tag" \
        --arg total "$total_tags" \
        --arg semver "$semver_count" \
        '{
            pattern: $pattern,
            uses_v_prefix: $has_v_prefix,
            latest_tag: $latest,
            stats: {
                total_tags: ($total | tonumber),
                semver_tags: ($semver | tonumber)
            }
        }'
}

# Analyze default branch
analyze_default_branch() {
    local default_branch
    default_branch=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' || echo "")

    if [ -z "$default_branch" ]; then
        # Try to detect from common names
        if git show-ref --verify --quiet refs/heads/main 2>/dev/null; then
            default_branch="main"
        elif git show-ref --verify --quiet refs/heads/master 2>/dev/null; then
            default_branch="master"
        fi
    fi

    jq -n --arg branch "$default_branch" '{default_branch: $branch}'
}

# Run all analyses
COMMIT_CONVENTION=$(analyze_commit_convention)
BRANCH_NAMING=$(analyze_branch_naming)
MERGE_STRATEGY=$(analyze_merge_strategy)
RELEASES=$(analyze_releases)
DEFAULT_BRANCH=$(analyze_default_branch)

# Build final JSON output
jq -n \
    --argjson commits "$COMMIT_CONVENTION" \
    --argjson branches "$BRANCH_NAMING" \
    --argjson merge "$MERGE_STRATEGY" \
    --argjson releases "$RELEASES" \
    --argjson default "$DEFAULT_BRANCH" \
    '{
        commit_convention: $commits,
        branch_naming: $branches,
        merge_strategy: $merge,
        releases: $releases,
        default_branch: $default.default_branch
    }'
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall