docs: update AGENTS.md via Apex Optimizer

Author: chirag127

AGENTS.md

@@ -8,6 +8,7 @@
 
 ---
 
+
 ## 2. INPUT PROCESSING & COGNITION
 *   **SPEECH-TO-TEXT INTERPRETATION PROTOCOL:**
     *   **Context:** User inputs may contain phonetic errors (homophones, typos).
@@ -21,94 +22,16 @@
 
 ---
 
+
 ## 3. CONTEXT-AWARE APEX TECH STACKS (LATE 2025 STANDARDS)
-**Directives:** Detect the project type and apply the corresponding **Apex Toolchain**. This repository, `DevCore-Software-Design-Principles-Handbook`, is a documentation and knowledge-base project.
+**Directives:** Detect the project type and apply the corresponding **Apex Toolchain**. This repository, `DevCore-Software-Design-Principles-Handbook`, is a documentation and knowledge-sharing project.
 
-*   **PRIMARY SCENARIO: DOCUMENTATION / KNOWLEDGE BASE / HANDBOOK**
-    *   **Stack:** This project is primarily static content with potential for Markdown rendering and search functionality. We will leverage standard documentation tools. 
-        *   **Static Site Generator (Optional but Recommended for Professional Presentation):** Consider **Astro** for its performance and flexibility in rendering Markdown with potential for modern JavaScript integration. Alternatively, a robust Markdown renderer within a simple tooling setup.
-        *   **Content Format:** **Markdown** (CommonMark/GFM) is the primary format. Structure is paramount.
-        *   **Versioning:** Git for source control. Tags for releases.
-    *   **Architecture:** A clear, hierarchical structure. Content is King. The architecture supports discoverability and maintainability of knowledge.
-    *   **Verification:** Automated checks for broken links, proper Markdown syntax, and consistent formatting.
+*   **PRIMARY SCENARIO: DOCUMENTATION / KNOWLEDGE BASE (Markdown)**
+    *   **Stack:** This project is primarily a **Markdown-based knowledge repository**. Core tooling includes **MkDocs** for static site generation, **Material for MkDocs** theme for a professional presentation, and ** tumbuhan-lint/markdownlint** for consistent Markdown formatting.
+    *   **Architecture:** Utilizes a **Hierarchical / Topical structure** for organizing knowledge, ensuring logical flow and easy navigation. Adheres to principles of clear, concise documentation suitable for a handbook.
+    *   **Verification:** Content integrity is maintained through **manual review** and automated checks for broken links and consistent formatting.
 
-*   **SECONDARY SCENARIO A: WEB / APP / EXTENSION (TypeScript) - *Not directly applicable, but principles for maintainable codebases apply.***
+*   **SECONDARY SCENARIO A: WEB / APP / EXTENSION (TypeScript) - *Not applicable for this project's primary function.***
     *   **Stack:** TypeScript 6.x (Strict), Vite 7 (Rolldown), Tauri v2.x (Native), WXT (Extensions).
     *   **State:** Signals (Standardized).
-
-*   **TERTIARY SCENARIO B: SYSTEMS / PERFORMANCE (Rust/Go) - *Not applicable.***
-    *   **Stack:** Rust (Cargo) or Go (Modules).
-    *   **Lint:** Clippy / GolangCI-Lint.
-    *   **Architecture:** Hexagonal Architecture (Ports & Adapters).
-
-*   **QUATERNARY SCENARIO C: DATA / AI / SCRIPTS (Python) - *Not applicable.***
-    *   **Stack:** uv (Manager), Ruff (Linter), Pytest (Test).
-    *   **Architecture:** Modular Monolith or Microservices.
-
----
-
-## 4. OPERATIONAL DIRECTIVES (APEX PROTOCOL ALPHA)
-*   **CODE QUALITY & CONSISTENCY:**
-    *   **LINTING & FORMATTING:** Enforce rigorous linting and formatting standards. For documentation projects, this translates to Markdown linters (e.g., `markdownlint`) and style consistency. ALL content MUST pass these checks.
-    *   **TESTING:** Automated checks for documentation integrity. This includes:
-        *   **Link Checkers:** Verify all internal and external hyperlinks are valid.
-        *   **Markdown Syntax Validation:** Ensure correct Markdown structure.
-        *   **Spell Check:** Integrated spell-checking mechanisms.
-    *   **PRINCIPLES:** Adherence to **SOLID, DRY, KISS, YAGNI** applies to the *structure* and *management* of the documentation, not just code.
-
-*   **SECURITY & COMPLIANCE (The "Standard 11" & Beyond):**
-    *   **LICENSE:** All code and documentation MUST be under **CC BY-NC 4.0**.
-    *   **CONTRIBUTING:** Clearly defined contribution guidelines (`CONTRIBUTING.md`).
-    *   **ISSUE TEMPLATES:** Standardized templates for bug reports and feature requests (`.github/ISSUE_TEMPLATE/`).
-    *   **PULL REQUEST TEMPLATES:** Standardized templates for PRs (`.github/PULL_REQUEST_TEMPLATE.md`).
-    *   **SECURITY POLICY:** A dedicated security policy file (`.github/SECURITY.md`).
-    *   **CI/CD:** Robust CI pipeline (`.github/workflows/ci.yml`) to automate checks and builds.
-    *   **BADGES:** Comprehensive badge implementation (`badges.yml`) for visibility.
-    *   **GITIGNORE:** Maintain a clean `.gitignore` file.
-
-*   **DOCUMENTATION AS AN ARTIFACT:**
-    *   **ARCHIVAL:** Even archived projects must be meticulously documented and professionally presented.
-    *   **PROFESSIONAL PRESENTATION:** ALL repositories will have a **Hero-Tier README.md**, a `PROPOSED_README.md` outlining agent directives, and a comprehensive `AGENTS.md` detailing operational protocols.
-    *   **AGENT INTERACTION:** The `AGENTS.md` file serves as the **direct instruction set** for AI agents interacting with this repository. Ensure it is specific, actionable, and aligned with the project's nature.
-
----
-
-## 5. AGENT DIRECTIVES FOR THIS REPOSITORY (`DevCore-Software-Design-Principles-Handbook`)
-
-**Repository URL:** `https://github.com/chirag127/DevCore-Software-Design-Principles-Handbook`
-
-*   **PRIMARY FUNCTION:** To serve as a definitive, high-authority handbook on software engineering principles and design patterns.
-
-*   **CONTENT FOCUS:**
-    *   Deep dives into SOLID principles.
-    *   Comprehensive catalog of design patterns (Gang of Four, architectural patterns, etc.).
-    *   Best practices for clean code, maintainability, scalability, and testability.
-    *   Explanations of architectural concepts.
-    *   Comparative analysis of different approaches.
-
-*   **TECHNOLOGY STACK CONSIDERATIONS FOR AGENTS:**
-    *   **Content Management:** Agents must interact with Markdown files (`.md`). Primary tools for content generation or editing should be Markdown-aware.
-    *   **Validation Tools:** Agents must be capable of utilizing Markdown linters (e.g., `markdownlint` via `npm install -g markdownlint-cli` or similar equivalent for Python if integrated) and link checkers (e.g., `markdown-link-check` via `npm` or Python equivalents). Spell-checking tools should also be integrated.
-    *   **CI/CD Integration:** Agents must understand that their outputs will be subject to CI/CD pipelines defined in `.github/workflows/ci.yml`. Ensure generated or modified content is compliant.
-
-*   **OPERATIONAL AGENT TASKS:**
-    1.  **Content Enhancement:** Identify areas for deeper explanation, additional examples, or improved clarity. Suggest and implement (if authorized) these improvements in Markdown.
-    2.  **Pattern & Principle Identification:** Proactively identify instances where specific principles or patterns are discussed or could be applied within the handbook's content.
-    3.  **Consistency Checks:** Ensure terminology, formatting, and structural consistency across the entire handbook.
-    4.  **Broken Link Detection & Correction:** Regularly scan for and fix broken hyperlinks.
-    5.  **Feature Requests:** Log potential new sections or topics for future expansion.
-    6.  **Cross-referencing:** Establish and maintain links between related concepts and patterns.
-
-*   **DO NOT:** Do not attempt to compile code, run complex algorithms, or interact with APIs unrelated to documentation management or knowledge synthesis for this handbook.
-
-*   **DO:** Focus on the quality, accuracy, and accessibility of the knowledge presented.
-
----
-
-## 6. COMMUNICATION PROTOCOL
-*   **DIRECTIVES:** All commands and interactions with agents must be explicit and referential. Use the structure defined in this document.
-*   **FEEDBACK:** Agents should report adherence to directives and any encountered obstacles.
-
----
-
-**END OF AGENTS.MD**
+...