From 0219cf227b659b5655cfd3421f09981aea126ce1 Mon Sep 17 00:00:00 2001
From: CoderDeltaLAN <CoderDeltaLAN@users.noreply.github.com>
Date: Tue, 9 Jun 2026 12:57:23 +0100
Subject: [PATCH] docs: improve discoverability metadata

---
 CHANGELOG.md   |  2 ++
 README.md      |  6 ++++--
 pyproject.toml | 11 +++++++++--
 3 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3910189..4399ba5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,8 @@ This project has no stable public release yet.
 
 ### Changed
 
+- Improved README and project metadata for clearer GitHub and Python package discoverability.
+- Added project URLs and more specific package keywords.
 - Updated README status after publishing `v0.1.0` as a GitHub pre-release.
 - Added basic installation guidance for release artifacts.
 
diff --git a/README.md b/README.md
index eab7c74..3313b92 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@
 <h1 align="center">agent-rules-kit</h1>
 
 <p align="center">
-  <strong>Local Python CLI for diagnosing baseline quality of AI agent instruction files in repositories.</strong>
+  <strong>Local read-only Python CLI for diagnosing AGENTS.md, CLAUDE.md, GEMINI.md, Cursor rules, GitHub Copilot instructions, and other AI agent instruction files in repositories.</strong>
 </p>
 
 <p align="center">
@@ -86,7 +86,9 @@
 
 ## Overview
 
-`agent-rules-kit` is a local diagnostic CLI for repositories that use AI coding agents or assistant-specific instruction files.
+`agent-rules-kit` is a local, read-only diagnostic CLI for repositories that use AI coding agents or assistant-specific instruction files.
+
+It helps developers inspect `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Cursor rules, GitHub Copilot instructions, and GitHub instruction files without network calls, LLM calls, or repository command execution.
 
 It focuses on files such as:
 
diff --git a/pyproject.toml b/pyproject.toml
index f9f5bc7..fdc2505 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -5,12 +5,12 @@ build-backend = "hatchling.build"
 [project]
 name = "agent-rules-kit"
 version = "0.1.0"
-description = "Local CLI to diagnose baseline quality of AI agent instruction files in repositories."
+description = "Local read-only CLI to diagnose AGENTS.md, Claude Code, Gemini CLI, Cursor and Copilot instruction files."
 readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "MIT" }
 authors = [{ name = "CoderDeltaLAN" }]
-keywords = ["agents", "cli", "lint", "ai", "repository"]
+keywords = ["ai-agents", "agent-instructions", "agents-md", "cli", "developer-tools", "python", "linting", "code-quality", "repository-diagnostics", "github-copilot", "cursor", "claude-code", "gemini-cli", "read-only", "local-first"]
 classifiers = [
   "Development Status :: 3 - Alpha",
   "Environment :: Console",
@@ -22,6 +22,13 @@ classifiers = [
 ]
 dependencies = []
 
+[project.urls]
+Repository = "https://github.com/CoderDeltaLAN/agent-rules-kit"
+Issues = "https://github.com/CoderDeltaLAN/agent-rules-kit/issues"
+Changelog = "https://github.com/CoderDeltaLAN/agent-rules-kit/blob/main/CHANGELOG.md"
+Security = "https://github.com/CoderDeltaLAN/agent-rules-kit/security/policy"
+Release = "https://github.com/CoderDeltaLAN/agent-rules-kit/releases/tag/v0.1.0"
+
 [project.scripts]
 agent-rules-kit = "agent_rules_kit.cli:main"