This file is a comprehensive, flat index of all rule files in this repository.
Note: For categorized views, usage examples, and architecture details, please see the Main README.
| File | Purpose |
|---|---|
android-app-launch-rules.md |
Automated protocol for emulator setup and deployment, optimized for M2 machines, with architecture and device fallbacks. |
| File | Purpose |
|---|---|
strict-dependency-freezing-rules.md |
Industrial protocol for ensuring reproducible builds by pinning exact versions of all external dependencies in package-level configuration. |
| File | Purpose |
|---|---|
zero-backend-sync-rules.md |
Architecture and implementation standards for background, invisible data synchronization using decentralized relays (Nostr), local-first storage (RxDB), and WASM hardening. |
| File | Purpose |
|---|---|
kmp-version-upgrade-rules.md |
A specific technical protocol for upgrading Kotlin, AGP, and related dependencies in a Kotlin Multiplatform project. |
| File | Purpose |
|---|---|
ci-cd-rules.md |
Principles and practices for CI/CD, including protected branches, security, observability, advanced deployment strategies, and automated rollbacks. |
github-actions-workflow-rules.md |
Rules for GitHub Actions workflows, covering trigger preferences, security, performance, and integrations. |
| File | Purpose |
|---|---|
shellcheck-fixer-rules.md |
Specialized rules for repairing shell scripts to meet ShellCheck standards. |
| File | Purpose |
|---|---|
ai-agent-planning-rules.md |
Guidelines for agent planning, including the core directive to plan before acting and a protocol for iterative plan revisions. |
ai-agent-session-documentation-rules.md |
Protocol for documenting AI agent sessions or conversations as Markdown, including file attachment references, structured data, and traceability. |
ai-tools-rules.md |
Comprehensive rules for AI tool usage, including mandates for output visibility, explicit user confirmation for file writes, and integration with agent planning and security protocols. |
github-cli-permission-rules.md |
Explicit permission protocol for running gh commands, ensuring user control and transparency. |
moltbridge-discovery-rules.md |
Industrial standards for social graph broker discovery, trust threshold mandates, and cross-tool analysis traceability. |
node-crypto-mcp-infrastructure-rules.md |
Industrial standards for Ed25519 reliability, Uint8Array sanitization, and Zero-Network MCP Server architecture. |
postman-mcp-server-rules.md |
Standards for configuring, using, and troubleshooting the Postman MCP Server in AI agent environments. |
shell-execution-rules.md |
Guidelines for shell command execution, ensuring transparency, user control, and adherence to security protocols. |
| File | Purpose |
|---|---|
zero-data-loss-cloud-cleanup-rules.md |
Mandatory verification protocol before deleting cloud-synced local files to prevent data loss. |
| File | Purpose |
|---|---|
rclone-download-rules.md |
Protocol for efficient, reliable, and user-controlled rclone downloads with progress tracking, size-based ordering, and integrity verification. |
| File | Purpose |
|---|---|
flutter-app-development-rules.md |
Rules for Flutter app development, including version pinning with mise, dependency management, and mandatory documentation. |
| File | Purpose |
|---|---|
git-atomic-commit-construction-rules.md |
Authoritative protocol for analyzing, grouping, and arranging changes into logical, independent atomic units before execution. |
git-commit-message-rules.md |
Strict rules for generating git commit messages, enforcing Conventional Commits, contextual information in titles, and no redundancy between title and body. |
git-gitignore-handling-rules.md |
Protocols for generating, maintaining, and customizing .gitignore files using standard APIs. |
git-history-refinement-rules.md |
Protocols for refining existing commit history using backup branches, jq for JSON atomicity, and tree parity verification. |
git-operation-rules.md |
Strict protocols for standard Git operations (commits & pushes), mandating explicit user requests and forbidding auto-actions. |
git-rebase-standardization-rules.md |
Industrial protocol for hierarchical branch rebasing, cross-branch deduplication, and literal commit fidelity. |
git-repo-management-rules.md |
Comprehensive protocol for the repository lifecycle, including standardized creation, CLI-based cloning, submodule initialization, and auto-indexing. |
git-submodule-history-repair-rules.md |
Protocols for repairing broken submodule pointers caused by history rewrites in submodule repositories. |
git-submodule-rules.md |
Protocols for managing submodules, preventing detached HEAD states, proper branch tracking, and descriptive parent commit messages. |
git-text-normalization-rules.md |
Rules to ensure Git treats text files correctly across encodings and platforms, preventing binary diffs and EOL churn. |
github-pr-management-rules.md |
Sequential, CLI-first protocols for handling Pull Requests, emphasizing security for private repositories and explicit user handoff. |
github-repo-metadata-management-rules.md |
Ultra-Lean Industrial protocols for Metadata-as-Code (MaC), using README.md as the absolute Single Source of Truth with visible markers for automation. |
repo-discovery-rules.md |
Multi-platform repository discovery and smart cloning workflows. |
| File | Purpose |
|---|---|
GitHub-Action-Creation-rules.md |
Strict guidelines for creating, structuring, and publishing GitHub Composite Actions to the Marketplace. enforce "Industrial" standards. |
| File | Purpose |
|---|---|
typescript-rules.md |
Industrial standards for TypeScript configuration, strictness, and strict dependency freezing. |
| File | Purpose |
|---|---|
brew-rules.md |
Comprehensive SSOT for Homebrew operations, including installation preferences, keg-only handling, and exclusion-based upgrade workflows. |
| File | Purpose |
|---|---|
manual-testing-rules.md |
Authoritative protocol for designing, documenting, and executing manual verification plans. |
| File | Purpose |
|---|---|
ai-rule-standardization-rules.md |
Craftsmanship standards for developing "Ultra-Lean Industrial" AI Agent Rules, ensuring consistent formatting, structural hierarchy, and pedagogical clarity. |
| File | Purpose |
|---|---|
redaction-portability-rules.md |
Public-vs-organization-private repository scope tiers, asymmetric inter-repo linking rules, three sensitivity tiers (identity / topology / public), canonical placeholder vocabulary, and prohibited behaviors that keep every produced artifact safe to publish and portable across machines. |
| File | Purpose |
|---|---|
bash-scripting-rules.md |
Industrial standards for bash script development, including dependency management patterns, alphabetical organization conventions, and idempotent function design. |
| File | Purpose |
|---|---|
linkedin-contributor-call-rules.md |
Specialized protocol for drafting "Call for Contributors" posts to recruit developers for personal projects, focusing on mentorship, labour-rich stacks, and leadership. |
linkedin-post-creation-rules.md |
Protocol for crafting viral, professional, and accessible LinkedIn posts customized for Banee Ishaque K's persona, emphasizing plain-text optimization and human storytelling. |
| File | Purpose |
|---|---|
rule-management-rules.md |
Documentation sync and update workflow, including metadata management for rule indexing. |
script-management-rules.md |
Script standards, folder usage, and safeguards for helper scripts. |
scripting-language-selection-rules.md |
Decision framework for picking the right scripting / programming language for a given automation, tool, or one-off task — Python as the default, PowerShell as the cross-platform shell-glue, a systems-language tier (C / Go / Rust / Zig) for CPU-bound work, and a special-occasion tier (Java / C# / Node.js / PHP) reserved for ecosystem-driven cases. |
| File | Purpose |
|---|---|
github-atom-feed-rules.md |
Protocol for generating and providing GitHub repository Atom feed URLs for commits and releases |