@wazir-dev/cli 1.0.0

package/expertise/index.md

@@ -0,0 +1,113 @@
+# Directory Purpose
+
+The `expertise` directory is the central knowledge base defining architectural standards, design principles, security policies, and performance guidelines. It provides AI agents with context on system design, technology-specific best practices, and anti-patterns to avoid.
+
+# Key Concepts
+
+- Architectural patterns & distributed systems
+- System performance & infrastructure scaling
+- Application security & vulnerability mitigation
+- UI/UX design, accessibility, & psychology
+- Code quality, testing, & technical debt
+
+# File Map
+
+- `PROGRESS.md` — tracks overall completion of expertise content
+- `index.md` — semantic map of the knowledge base
+
+# Subdirectories
+
+## `/i18n` — internationalization, localization, and RTL
+- `/foundations` — architecture, Unicode, locale tags, string externalization, pluralization, dates, numbers, BiDi
+- `/rtl` — RTL fundamentals, layout mirroring, typography, icons, navigation, forms, animations, testing, Arabic-specific, Hebrew-specific
+- `/platform` — Flutter, React, Web CSS, iOS, Android, Backend i18n
+- `/content` — translation management, machine translation, content adaptation
+- `/advanced` — BiDi algorithm, complex scripts, accessibility, performance, testing
+
+## `/antipatterns` — common mistakes and technical debt
+- `/backend` — database, caching, auth, and API anti-patterns
+- `/code` — smells, async, error handling, and testing flaws
+- `/design` — accessibility fails, dark patterns, and bad UX
+- `/frontend` — SPA, CSS, and mobile UI anti-patterns
+- `/performance` — premature optimization and scaling flaws
+- `/process` — code review, deployment, and AI coding pitfalls
+- `/security` — security theater and secrets mismanagement
+
+## `/architecture` — system design and distributed patterns
+- `/data` — caching, event streams, search, and SQL vs NoSQL
+- `/decisions` — ADRs, build vs buy, and tech selection
+- `/distributed` — CAP theorem, circuit breakers, and sagas
+- `/foundations` — DDD, SOLID, coupling, and 12-factor apps
+- `/integration` — REST, GraphQL, gRPC, and webhooks
+- `/mobile-architecture` — BFF, offline-first, and push sync
+- `/patterns` — microservices, event-driven, CQRS, and monoliths
+- `/scaling` — database scaling, multi-tenancy, and stateless design
+
+## `/backend` — backend framework standards
+- `go.md`, `rust.md` — systems programming guidelines
+- `java-spring.md` — Spring Boot enterprise standards
+- `node-typescript.md`, `python-fastapi.md` — web API best practices
+
+## `/design` — UI/UX methodology and foundations
+- `/disciplines` — design systems, user research, and interaction
+- `/foundations` — typography, spacing, color theory, and a11y
+- `/patterns` — auth flows, onboarding, and data display
+- `/platforms` — mobile (iOS/Android), desktop, and responsive web
+- `/psychology` — cognitive load and user mental models
+
+## `/humanize` -- AI text humanization and writing quality
+- `vocabulary-blacklist.md` -- 61-item blacklist of AI vocabulary with replacements and domain exceptions
+- `sentence-patterns.md` -- 24-pattern taxonomy with burstiness targets and before/after examples
+- `domain-rules-technical-docs.md` -- rules for specs, plans, architecture docs
+- `domain-rules-code.md` -- rules for commit messages, code comments, PR descriptions
+- `domain-rules-content.md` -- rules for microcopy, glossary, notifications, seed content
+- `self-audit-checklist.md` -- two-pass verification checklist
+
+## `/frontend` — frontend framework standards
+- `react.md`, `angular.md`, `vue.md` — web SPA guidelines
+- `flutter.md`, `native-android.md`, `native-ios.md`, `react-native.md` — mobile app standards
+- `desktop-electron.md` — desktop app best practices
+
+## `/infrastructure` — cloud, devops, and databases
+- `cloud-aws.md`, `cloud-gcp.md` — public cloud architectures
+- `cybersecurity.md` — securing infrastructure perimeters and zero-trust
+- `database-postgres.md`, `database-mongodb.md` — database tuning
+- `devops-cicd.md` — deployment pipeline rules
+
+## `/performance` — optimization strategies across stacks
+- `/backend` — API latency, connection pooling, and background jobs
+- `/foundations` — memory management, caching, and algorithmic complexity
+- `/infrastructure` — load balancing, auto-scaling, and CDN
+- `/mobile` — startup time, battery, and rendering
+- `/platform-specific` — Node, React, Postgres, and Flutter tuning
+- `/web` — bundle optimization, Core Web Vitals, and SSR
+
+## `/quality` — testing methodologies
+- `testing-api.md`, `testing-web.md`, `testing-mobile.md` — E2E and unit testing
+- `accessibility.md`, `performance.md` — quality audits
+
+## `/security` — application security and defensive coding
+- `/data` — encryption, GDPR, and database security
+- `/foundations` — OWASP top 10, IAM, cryptography, and secrets
+- `/infrastructure` — cloud, container, and network security
+- `/mobile` — iOS/Android security, data storage, and binary protection
+- `/testing` — penetration testing, threat modeling, and vulnerability scanning
+- `/web` — XSS, CSRF, API security, and session management
+
+# Dependencies
+
+Uses:
+- General software engineering industry standards (SOLID, DRY, DDD)
+- OWASP Top 10 guidelines for security
+- Core Web Vitals for performance measurement
+
+# Reading Guide
+
+If designing a new system → read `/architecture/foundations` and `/architecture/decisions`
+If reviewing code for vulnerabilities → read `/security/testing` and `/antipatterns/security`
+If optimizing application speed → read `/performance/foundations` and platform specific docs
+If debugging code quality or smells → read `/antipatterns/code`
+If updating CI/CD pipelines → read `/infrastructure/devops-cicd.md`
+If designing user interfaces → read `/design/foundations` and `/design/psychology`
+If adding i18n or RTL support → read `/i18n/foundations` and `/i18n/rtl`
+If humanizing text or removing AI writing patterns → read `/humanize/index.md`

package/expertise/index.yaml

@@ -0,0 +1,216 @@
+modules:
+  - id: antipatterns
+    path: expertise/antipatterns
+    domain: review
+    use_cases:
+      - adversarial review
+      - planning risk checks
+      - implementation quality checks
+    review_applicability:
+      - plan_review
+      - review
+      - learn
+    freshness_date: 2026-03-11
+  - id: architecture
+    path: expertise/architecture
+    domain: system-design
+    use_cases:
+      - specification
+      - planning
+      - migration analysis
+    review_applicability:
+      - specify
+      - plan
+      - review
+    freshness_date: 2026-03-11
+  - id: backend
+    path: expertise/backend
+    domain: implementation
+    use_cases:
+      - backend feature work
+      - stack-specific review
+    review_applicability:
+      - execute
+      - review
+    freshness_date: 2026-03-11
+  - id: design
+    path: expertise/design
+    domain: product-design
+    use_cases:
+      - design review
+      - UX planning
+    review_applicability:
+      - clarify
+      - specify
+      - review
+    freshness_date: 2026-03-11
+  - id: frontend
+    path: expertise/frontend
+    domain: implementation
+    use_cases:
+      - frontend feature work
+      - stack-specific review
+    review_applicability:
+      - execute
+      - review
+    freshness_date: 2026-03-12
+  - id: i18n
+    path: expertise/i18n
+    domain: product-quality
+    use_cases:
+      - localization planning
+      - rtl review
+    review_applicability:
+      - specify
+      - review
+    freshness_date: 2026-03-11
+  - id: infrastructure
+    path: expertise/infrastructure
+    domain: operations
+    use_cases:
+      - deployment planning
+      - infra review
+    review_applicability:
+      - plan
+      - review
+    freshness_date: 2026-03-11
+  - id: performance
+    path: expertise/performance
+    domain: performance
+    use_cases:
+      - performance-sensitive planning
+      - profiling and optimization review
+    review_applicability:
+      - plan
+      - review
+    freshness_date: 2026-03-11
+  # --- Expansion modules (2026-03-12, gap analysis from agency-agents) ---
+  - id: quality-evidence-verification
+    path: expertise/quality/evidence-based-verification.md
+    domain: quality
+    use_cases:
+      - QA verification
+      - evidence-based review
+    review_applicability:
+      - verify
+      - review
+    freshness_date: 2026-03-12
+  - id: security-compliance
+    path: expertise/security/compliance-frameworks.md
+    domain: compliance
+    use_cases:
+      - regulatory compliance
+      - data privacy
+    review_applicability:
+      - specify
+      - review
+    freshness_date: 2026-03-12
+  - id: quality-ml-audit
+    path: expertise/quality/ml-model-audit.md
+    domain: quality
+    use_cases:
+      - ML model validation
+      - model monitoring
+    review_applicability:
+      - verify
+      - review
+    freshness_date: 2026-03-12
+  - id: backend-solidity
+    path: expertise/backend/solidity.md
+    domain: implementation
+    use_cases:
+      - smart contract development
+      - Web3 features
+    review_applicability:
+      - execute
+      - review
+    freshness_date: 2026-03-12
+  - id: security-smart-contracts
+    path: expertise/security/smart-contract-security.md
+    domain: security
+    use_cases:
+      - smart contract audit
+      - Web3 security
+    review_applicability:
+      - verify
+      - review
+    freshness_date: 2026-03-12
+  - id: backend-embedded
+    path: expertise/backend/embedded-firmware.md
+    domain: implementation
+    use_cases:
+      - firmware development
+      - IoT features
+    review_applicability:
+      - execute
+      - review
+    freshness_date: 2026-03-12
+  - id: security-agentic-identity
+    path: expertise/security/agentic-identity.md
+    domain: security
+    use_cases:
+      - multi-agent security
+      - agent trust
+    review_applicability:
+      - specify
+      - review
+    freshness_date: 2026-03-12
+  - id: design-behavioral-nudges
+    path: expertise/design/psychology/behavioral-nudges.md
+    domain: product-design
+    use_cases:
+      - UX design
+      - user engagement
+    review_applicability:
+      - clarify
+      - specify
+    freshness_date: 2026-03-12
+  - id: design-microinteractions
+    path: expertise/design/patterns/microinteractions.md
+    domain: product-design
+    use_cases:
+      - UI polish
+      - animation design
+    review_applicability:
+      - execute
+      - review
+    freshness_date: 2026-03-12
+  - id: frontend-react-native
+    path: expertise/frontend/react-native.md
+    domain: implementation
+    use_cases:
+      - React Native feature work
+      - Expo / cross-platform mobile development
+    review_applicability:
+      - execute
+      - review
+    freshness_date: 2026-03-12
+  - id: content
+    path: expertise/content
+    domain: content-authoring
+    use_cases:
+      - microcopy
+      - localization
+      - content modeling
+      - editorial standards
+    review_applicability:
+      - author
+      - design_review
+      - review
+    freshness_date: 2026-03-14
+  - id: humanize
+    path: expertise/humanize
+    domain: writing-quality
+    use_cases:
+      - text humanization
+      - AI pattern removal
+      - writing quality
+      - burstiness enforcement
+    review_applicability:
+      - specify
+      - plan
+      - execute
+      - author
+      - review
+      - learn
+    freshness_date: 2026-03-16