RRepoGEO

REPOGEO REPORT · LITE

ciembor/agent-rules-books

Default branch main · commit a7d76490 · scanned 5/18/2026, 4:51:51 PM

GitHub: 1,469 stars · 211 forks

Scan history for this repo

Score trend below includes all ready runs (older left, newer right; scroll horizontally if needed). The table is collapsed by default—expand for newest-first rows, 10 per page.

Score trend (left → right: older → newer)

2 ready scans. Expand the table below for newest-first rows (10 per page, paginated).

AI VISIBILITY SCORE
27 /100
Critical
Category recall
0 / 2
Not recommended in any query
Rule findings
2 pass · 0 warn · 0 fail
Objective metadata checks
AI knows your name
1 / 3
Direct prompts that named your repo
HOW TO READ THIS REPORT

Action plan is what to do next — copy-pasteable changes prioritized by impact. Category visibility is the real GEO test: when a user asks an AI a brand-free question that should surface ciembor/agent-rules-books, does the AI actually recommend you — or your competitors? Objective checks verify the metadata signals AI engines weight first. Self-mention check detects whether AI even knows you exist by name.

Action plan — copy-paste fixes

3 prioritized changes generated by gemini-2.5-flash. Mark items done after you ship the fix.

OVERALL DIRECTION
  • highreadme#1
    Reposition README H1 and description to clarify 'AI coding agents' and 'software engineering principles'

    Why:

    CURRENT
    <h1 align="center">AI agents Rules / Skills from<br />Programming Books v0.5</h1>

<p align="center"><strong>AGENTS.md rules</strong> / <strong>skills</strong> for <strong>Codex</strong>, <strong>Cursor</strong>, <strong>Claude Code</strong>, distilled from classic <strong>software engineering books</strong> about refactoring, architecture, DDD and code quality.</p>

Description: AGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.
    COPY-PASTE FIX
    <h1 align="center">Software Engineering Principles for AI Coding Agents<br />(Rules / Skills from Programming Books v0.5)</h1>

<p align="center"><strong>AGENTS.md rules</strong> / <strong>skills</strong> to guide <strong>AI coding agents</strong> like <strong>Codex</strong>, <strong>Cursor</strong>, and <strong>Claude Code</strong>, distilling classic <strong>software engineering books</strong> on refactoring, architecture, DDD, and code quality into actionable prompts.</p>

Description: Actionable AGENTS.md rules / skills to guide AI coding agents (Codex, Cursor, Claude Code) in applying Clean Code, Refactoring, DDD, Clean Architecture, and DDIA principles to AI-generated code.
  • mediumtopics#2
    Add more specific topics to reinforce AI coding agent guidance

    Why:

    CURRENT
    agent-rules, agent-skills, agents-md, ai-agent, ai-skills, claude-code, claude-code-skills, code-quality, codex, codex-skills, cursor-rules, cursor-skills, domain-driven-design, programming-books, refactoring
    COPY-PASTE FIX
    agent-rules, agent-skills, agents-md, ai-agent, ai-coding-assistant, ai-skills, claude-code, claude-code-skills, code-quality, codex, codex-skills, cursor-rules, cursor-skills, domain-driven-design, programming-books, refactoring, software-engineering-for-ai, ai-code-quality
  • lowreadme#3
    Add a 'Comparison' section to the README

    Why:

    COPY-PASTE FIX
    ## Comparison to other tools

Unlike linters (ESLint, Prettier) or static analysis tools (SonarQube, CodeClimate) that analyze existing code, this repository provides *guidelines and rule sets* for *AI coding agents* to *generate* cleaner, more maintainable code from the outset. It is not a security rule engine like Wazuh, but rather a framework for applying classic software engineering principles to AI-assisted development.

Category GEO backends resolved for this scan: google/gemini-2.5-flash, deepseek/deepseek-v4-flash

Category visibility — the real GEO test

Brand-free queries asked to google/gemini-2.5-flash. Did AI recommend you, or someone else?

Same questions for every model — switch tabs to compare answers and rankings.

Recall
0 / 2
0% of queries surface ciembor/agent-rules-books
Avg rank
—
Lower is better. #1 = top recommendation.
Share of voice
0%
Of all named tools, what % are you?
Top rival
ESLint
Recommended in 1 of 2 queries
COMPETITOR LEADERBOARD
  1. ESLint · recommended 1×
  2. Prettier · recommended 1×
  3. SonarQube · recommended 1×
  4. CodeClimate · recommended 1×
  5. Husky · recommended 1×
  • CATEGORY QUERY
    How can I guide my AI coding assistant to write cleaner, more maintainable code?
    you: not recommended
    AI recommended (in order):
    1. ESLint
    2. Prettier
    3. SonarQube
    4. CodeClimate
    5. Husky
    6. lint-staged
    7. Reviewdog
    8. GitHub Actions
    9. GitLab CI/CD
    10. Jenkins

    AI recommended 10 alternatives but never named ciembor/agent-rules-books. This is the gap to close.

    Show full AI answer
  • CATEGORY QUERY
    What frameworks or guidelines exist to apply classic software design principles to AI-generated code?
    you: not recommended
    AI recommended (in order):
    1. SOLID Principles
    2. Design Patterns
    3. Clean Code
    4. Domain-Driven Design
    5. Test-Driven Development
    6. Layered Architecture
    7. Microservices
    8. Hexagonal Architecture

    AI recommended 8 alternatives but never named ciembor/agent-rules-books. This is the gap to close.

    Show full AI answer

Objective checks

Rule-based audits of metadata signals AI engines weight most.

  • Metadata completeness
    pass

  • README presence
    pass

Self-mention check

Does AI even know your repo exists when asked about it directly?

  • Compared to common alternatives in this category, what is the core differentiator of ciembor/agent-rules-books?
    pass
    AI did not name ciembor/agent-rules-books — likely talking about a different project

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

  • If a team adopts ciembor/agent-rules-books in production, what risks or prerequisites should they evaluate first?
    pass
    AI named ciembor/agent-rules-books explicitly

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

  • In one sentence, what problem does the repo ciembor/agent-rules-books solve, and who is the primary audience?
    pass
    AI did not name ciembor/agent-rules-books — likely talking about a different project

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

Embed your GEO score

Drop this badge into the README of ciembor/agent-rules-books. It auto-updates whenever the report is rescanned and links back to the latest report — easy public proof that you care about AI discoverability.

RepoGEO badge previewLive preview
MARKDOWN (README)
[![RepoGEO](https://repogeo.com/badge/ciembor/agent-rules-books.svg)](https://repogeo.com/en/r/ciembor/agent-rules-books)
HTML
<a href="https://repogeo.com/en/r/ciembor/agent-rules-books"><img src="https://repogeo.com/badge/ciembor/agent-rules-books.svg" alt="RepoGEO" /></a>
Pro

Subscribe to Pro for deep diagnoses

ciembor/agent-rules-books — Lite scans stay free; this card itemizes Pro deep limits vs Lite.

  • Deep reports10 / month
  • Brand-free category queries5 vs 2 in Lite
  • Prioritized action items8 vs 3 in Lite
ciembor/agent-rules-books — RepoGEO report