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/verify-content.sh

View on GitHub
#!/usr/bin/env bash
# verify-content.sh - Verify AGENTS.md content against actual codebase state
# This script checks if documented information matches reality.
#
# CRITICAL: Never trust existing AGENTS.md content. Always verify.
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

PROJECT_DIR="${1:-.}"
VERBOSE=false
FIX_MODE=false
EXIT_CODE=0

# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

# Parse flags
while [[ $# -gt 0 ]]; do
    case $1 in
        --verbose|-v)
            VERBOSE=true
            shift
            ;;
        --fix)
            FIX_MODE=true
            shift
            ;;
        --help|-h)
            cat <<EOF
Usage: verify-content.sh [PROJECT_DIR] [OPTIONS]

Verify AGENTS.md content against actual codebase state.

This script extracts information from the actual codebase and compares
it against what's documented in AGENTS.md files. Reports discrepancies
that need manual review or correction.

Options:
  --verbose, -v     Show detailed comparison output
  --fix             Suggest fixes for common issues
  --help, -h        Show this help message

Verification checks:
  1. Documented files exist (scripts, modules, tests)
  2. Documented commands work (make targets)
  3. Counts are accurate (module count, script count)
  4. Descriptions match actual docstrings

Exit codes:
  0 - All checks passed
  1 - Discrepancies found
  2 - Error running verification

Examples:
  verify-content.sh .                    # Verify current project
  verify-content.sh /path/to/project -v  # Verbose output
  verify-content.sh . --fix              # Show fix suggestions
EOF
            exit 0
            ;;
        *)
            PROJECT_DIR="$1"
            shift
            ;;
    esac
done

cd "$PROJECT_DIR"

echo "Verifying AGENTS.md content in: $(pwd)"
echo ""

# Track issues
declare -a ISSUES=()

add_issue() {
    local severity="$1"
    local message="$2"
    ISSUES+=("[$severity] $message")
    EXIT_CODE=1
}

log_check() {
    if [ "$VERBOSE" = true ]; then
        echo "  Checking: $1"
    fi
}

# ============================================================================
# VERIFICATION FUNCTIONS
# ============================================================================

# shellcheck disable=SC2329  # Called indirectly by verification driver
verify_file_exists() {
    local file="$1"
    local source="$2"
    if [ ! -f "$file" ] && [ ! -d "$file" ]; then
        add_issue "ERROR" "File documented in $source does not exist: $file"
        return 1
    fi
    return 0
}

verify_makefile_target() {
    local target="$1"
    if [ -f "Makefile" ]; then
        # Check in main Makefile and includes
        if ! grep -rq "^${target}:" Makefile Makefile.d/ 2>/dev/null; then
            add_issue "WARN" "Makefile target may not exist: $target"
            return 1
        fi
    fi
    return 0
}

extract_documented_files() {
    local agents_file="$1"
    # Extract file references like `filename.sh`, `filename.py`, etc.
    grep -oE '\`[a-zA-Z0-9_-]+\.(sh|py|go|php|ts|js|json)\`' "$agents_file" 2>/dev/null | tr -d '`' | sort -u || true
}

extract_documented_scripts() {
    local agents_file="$1"
    # Extract script references like install_python.sh, guide.sh
    grep -oE '\b[a-zA-Z0-9_-]+\.sh\b' "$agents_file" 2>/dev/null | sort -u || true
}

# ============================================================================
# ROOT AGENTS.MD VERIFICATION
# ============================================================================

echo "=== Verifying Root AGENTS.md ==="

if [ -f "AGENTS.md" ]; then
    echo -e "${GREEN}✓${NC} Root AGENTS.md exists"

    # Check documented make targets
    log_check "Makefile targets"
    DOCUMENTED_TARGETS=$(grep -oE 'make [a-z_-]+' AGENTS.md | sed 's/make //' | sort -u)
    for target in $DOCUMENTED_TARGETS; do
        verify_makefile_target "$target" || true
    done

    # Check for module count claims
    log_check "Module counts"
    MODULE_COUNTS=$(grep -oE '[0-9]+ (Python )?modules?' AGENTS.md | grep -oE '[0-9]+' || true)
    for count in $MODULE_COUNTS; do
        # Try to find actual module directories
        for dir in src cli_audit lib Classes app; do
            if [ -d "$dir" ]; then
                ACTUAL_COUNT=$(find "$dir" -maxdepth 1 -name "*.py" -o -name "*.php" -o -name "*.go" 2>/dev/null | wc -l)
                if [ "$ACTUAL_COUNT" -gt 0 ] && [ "$count" != "$ACTUAL_COUNT" ]; then
                    add_issue "WARN" "Module count mismatch in $dir: documented=$count, actual=$ACTUAL_COUNT"
                fi
            fi
        done
    done

    # Check for script count claims
    log_check "Script counts"
    SCRIPT_COUNTS=$(grep -oE '[0-9]+ (Bash )?scripts?' AGENTS.md | grep -oE '[0-9]+' || true)
    if [ -d "scripts" ] && [ -n "$SCRIPT_COUNTS" ]; then
        ACTUAL_SCRIPTS=$(find scripts -maxdepth 1 -name "*.sh" 2>/dev/null | wc -l)
        for count in $SCRIPT_COUNTS; do
            if [ "$count" != "$ACTUAL_SCRIPTS" ]; then
                add_issue "WARN" "Script count mismatch: documented=$count, actual=$ACTUAL_SCRIPTS"
            fi
        done
    fi
else
    add_issue "ERROR" "Root AGENTS.md does not exist"
fi

echo ""

# ============================================================================
# SCOPED AGENTS.MD VERIFICATION
# ============================================================================

echo "=== Verifying Scoped AGENTS.md Files ==="

# Find all scoped AGENTS.md files
SCOPED_FILES=$(find . -mindepth 2 -name "AGENTS.md" -not -path "./.git/*" 2>/dev/null || true)

for scoped_file in $SCOPED_FILES; do
    scope_dir=$(dirname "$scoped_file")
    scope_name=$(basename "$scope_dir")
    echo ""
    echo "Checking: $scoped_file"

    # Extract and verify documented files
    log_check "Documented files exist"
    DOCUMENTED=$(extract_documented_files "$scoped_file")

    for doc_file in $DOCUMENTED; do
        # Check if file exists relative to scope or project root
        if [ ! -f "${scope_dir}/${doc_file}" ] && [ ! -f "./${doc_file}" ] && [ ! -f "scripts/${doc_file}" ]; then
            # Special handling for common false positives
            case "$doc_file" in
                *.json|*.md|*.yml|*.yaml)
                    # Config files might be in various locations, skip
                    ;;
                *)
                    add_issue "ERROR" "File documented in $scoped_file does not exist: $doc_file"
                    ;;
            esac
        fi
    done

    # For scripts/ scope, verify all documented scripts exist
    if [ "$scope_name" = "scripts" ]; then
        log_check "Script files exist"
        SCRIPTS=$(extract_documented_scripts "$scoped_file")
        for script in $SCRIPTS; do
            # Check multiple locations: scripts/, scripts/lib/, ./
            if [ ! -f "scripts/$script" ] && [ ! -f "scripts/lib/$script" ] && [ ! -f "./$script" ]; then
                # Skip if it's in a commit message example (common pattern: feat(scripts): add xxx.sh)
                if grep -q "feat(scripts):.*$script\|fix(scripts):.*$script\|chore(scripts):.*$script" "$scoped_file" 2>/dev/null; then
                    [ "$VERBOSE" = true ] && echo "    Skipping $script (commit message example)"
                    continue
                fi
                add_issue "ERROR" "Script documented but does not exist: $script"
            fi
        done

        # Check for undocumented scripts
        log_check "All scripts documented"
        if [ -d "scripts" ]; then
            for actual_script in scripts/*.sh; do
                script_name=$(basename "$actual_script")
                if ! grep -q "$script_name" "$scoped_file" 2>/dev/null; then
                    add_issue "WARN" "Script exists but not documented: $script_name"
                fi
            done
        fi
    fi

    # For tests/ scope, verify test file listing
    if [ "$scope_name" = "tests" ]; then
        log_check "Test files documented"
        if [ -d "tests" ]; then
            for test_file in tests/test_*.py; do
                if [ -f "$test_file" ]; then
                    test_name=$(basename "$test_file")
                    if ! grep -q "$test_name" "$scoped_file" 2>/dev/null; then
                        add_issue "WARN" "Test file exists but not documented: $test_name"
                    fi
                fi
            done
        fi
    fi

    echo -e "${GREEN}✓${NC} Checked: $scoped_file"
done

# ============================================================================
# SUMMARY
# ============================================================================

echo ""
echo "=== Verification Summary ==="

if [ ${#ISSUES[@]} -eq 0 ]; then
    echo -e "${GREEN}✓ All verification checks passed!${NC}"
else
    echo -e "${RED}Found ${#ISSUES[@]} issue(s):${NC}"
    echo ""
    for issue in "${ISSUES[@]}"; do
        case "$issue" in
            *ERROR*)
                echo -e "  ${RED}$issue${NC}"
                ;;
            *WARN*)
                echo -e "  ${YELLOW}$issue${NC}"
                ;;
            *)
                echo "  $issue"
                ;;
        esac
    done

    if [ "$FIX_MODE" = true ]; then
        echo ""
        echo "=== Fix Suggestions ==="
        echo "1. Run extraction scripts to get actual state:"
        echo "   $SCRIPT_DIR/detect-project.sh ."
        echo "   $SCRIPT_DIR/extract-commands.sh ."
        echo ""
        echo "2. Compare extracted info with AGENTS.md content"
        echo ""
        echo "3. Update AGENTS.md files with verified information"
        echo ""
        echo "4. Re-run this verification: $0 . --verbose"
    fi
fi

echo ""
exit $EXIT_CODE
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: 470kUpdated 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: 197kUpdated 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: 197kUpdated 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: 197kUpdated Claude CodeCodexVerifiedInstall