@hanzlaa/rcode 3.6.16 → 4.1.0

package/rihal/team.yaml

@@ -1,610 +0,0 @@
-# Rihal v2 Agent Roster
-# Structured definition of all installed agents: roles, authority levels, domain keywords for council dispatch
-# Updated: 2026-04-23
-
-agents:
-  - id: rihal-sadiq
-    name: Sadiq (صادق)
-    file_path: rihal/agents/rihal-sadiq.md
-    skill_path: rihal/skills/agents/sadiq-analyst
-    role: Director of Strategy
-    authority_level: strategic
-    domain_keywords:
-      - strategy
-      - priority
-      - kill-criterion
-      - opportunity-cost
-      - should-we-build
-      - timing
-      - market-opportunity
-    description: Pushes for measurable outcomes and kill criteria. Answers "should we build this", "why now", "what NOT to do" questions.
-
-  - id: rihal-waleed
-    name: Waleed (وليد)
-    file_path: rihal/agents/rihal-waleed.md
-    skill_path: rihal/skills/agents/waleed-architect
-    role: Chief Technology Officer
-    authority_level: technical
-    domain_keywords:
-      - architecture
-      - stack
-      - feasibility
-      - security
-      - scale
-      - performance
-      - tech-debt
-      - database
-      - infrastructure
-    description: Answers architecture, stack selection, technical feasibility, security, and scale questions.
-
-  - id: rihal-fatima
-    name: Fatima (فاطمة)
-    file_path: rihal/agents/rihal-fatima.md
-    skill_path: rihal/skills/agents/fatima-qa
-    role: QA Lead
-    authority_level: quality
-    domain_keywords:
-      - quality
-      - testing
-      - test-strategy
-      - coverage
-      - release-readiness
-      - regression
-      - bugs
-      - qa-gates
-    description: Answers quality gates, test strategy, coverage, release readiness, and "is this production-ready" questions.
-
-  - id: rihal-mariam
-    name: Mariam (مريم)
-    file_path: rihal/agents/rihal-mariam.md
-    skill_path: rihal/skills/agents/mariam-marketing
-    role: Marketing & Growth Lead
-    authority_level: growth
-    domain_keywords:
-      - market-research
-      - discovery
-      - user-research
-      - gtm
-      - positioning
-      - messaging
-      - growth-strategy
-    description: Market research, user discovery, GTM strategy, positioning, and growth metrics.
-
-  - id: rihal-hussain-pm
-    name: Hussain (حسين)
-    file_path: rihal/agents/rihal-hussain-pm.md
-    skill_path: rihal/skills/agents/hussain-pm
-    role: Product Manager
-    authority_level: product
-    domain_keywords:
-      - scope
-      - requirements
-      - prd
-      - user-stories
-      - acceptance-criteria
-      - backlog
-    description: Scope, requirements, PRD writing, user stories, and backlog curation.
-
-  - id: rihal-hussain-sm
-    name: Hussain (حسين)
-    skill_path: rihal/skills/agents/hussain-sm
-    role: Scrum Master
-    authority_level: product
-    domain_keywords:
-      - sprint-planning
-      - story-preparation
-      - sprint-status
-      - retrospective
-      - course-correction
-      - agile-ceremonies
-    description: Sprint planning, story preparation, sprint status reporting, retrospectives, and mid-sprint course correction.
-
-  - id: rihal-yousef
-    name: Yousef (يوسف)
-    file_path: rihal/agents/rihal-yousef.md
-    skill_path: rihal/skills/agents/yousef-backend
-    role: Senior Backend Engineer
-    authority_level: technical
-    domain_keywords:
-      - backend
-      - api
-      - database
-      - performance
-      - latency
-      - queues
-      - webhooks
-      - integrations
-      - p50
-      - p95
-    description: Backend implementation, API design, database queries, performance tuning, and latency diagnosis.
-
-  - id: rihal-haitham
-    name: Haitham (هيثم)
-    file_path: rihal/agents/rihal-haitham.md
-    skill_path: rihal/skills/agents/haitham-frontend
-    role: Senior Frontend Engineer
-    authority_level: technical
-    domain_keywords:
-      - frontend
-      - react
-      - nextjs
-      - components
-      - rtl
-      - arabic-layout
-      - accessibility
-      - a11y
-      - bundle-size
-    description: React/Next.js, component design, RTL/Arabic layouts, accessibility, and frontend performance.
-
-  - id: rihal-zayd
-    name: Zayd (زيد)
-    file_path: rihal/agents/rihal-zayd.md
-    skill_path: rihal/skills/agents/zayd-ml
-    role: Senior ML Engineer
-    authority_level: technical
-    domain_keywords:
-      - ml
-      - machine-learning
-      - ocr
-      - llm
-      - rag
-      - retrieval
-      - embeddings
-      - vector-search
-      - nlp
-      - arabic-nlp
-    description: ML model selection, training, LLM integration, RAG/retrieval, vector search, and Arabic NLP.
-
-  - id: rihal-layla
-    name: Layla (ليلى)
-    file_path: rihal/agents/rihal-layla.md
-    skill_path: rihal/skills/agents/layla-designer
-    role: UX Designer
-    authority_level: design
-    domain_keywords:
-      - ux
-      - user-experience
-      - interaction-design
-      - user-flow
-      - wireframe
-      - design-system
-      - accessibility
-      - usability
-    description: User experience design, interaction flows, design systems, accessibility audits, and usability reviews.
-
-  - id: rihal-zahra
-    name: Zahra (زهرة)
-    file_path: rihal/agents/rihal-zahra.md
-    skill_path: rihal/skills/agents/zahra-branding
-    role: Branding & Creative Director
-    authority_level: design
-    domain_keywords:
-      - brand
-      - brand-identity
-      - typography
-      - arabic-typography
-      - color-system
-      - design-tokens
-      - visual-language
-      - brand-audit
-    description: Brand identity, visual language, typography systems (Latin + Arabic), color systems, and design tokens.
-
-  - id: rihal-nasser
-    name: Nasser (ناصر)
-    file_path: rihal/agents/rihal-nasser.md
-    skill_path: rihal/skills/agents/nasser-eng-manager
-    role: Software Engineering Manager
-    authority_level: management
-    domain_keywords:
-      - 1on1
-      - hiring
-      - onboarding
-      - growth-plan
-      - performance-review
-      - team-health
-      - burnout
-      - squad-composition
-    description: People operations, 1:1s, hiring, onboarding, growth plans, team health, and burnout detection.
-
-  - id: rihal-khalid
-    name: Khalid (خالد)
-    file_path: rihal/agents/rihal-khalid.md
-    role: DevOps & Infrastructure Engineer
-    authority_level: operational
-    domain_keywords:
-      - devops
-      - ci-cd
-      - deployment
-      - containers
-      - docker
-      - kubernetes
-      - monitoring
-      - infrastructure
-      - release-engineering
-    description: Deployment pipelines, CI/CD, container orchestration, cloud infrastructure, monitoring, and release engineering.
-
-  - id: rihal-noor
-    name: Noor (نور)
-    file_path: rihal/agents/rihal-noor.md
-    skill_path: rihal/skills/agents/noor-writer
-    role: Technical Writer & Presentation Lead
-    authority_level: operational
-    domain_keywords:
-      - documentation
-      - readme
-      - api-docs
-      - mermaid
-      - diagrams
-      - pitch-deck
-      - changelog
-      - blog-post
-      - migration-guide
-      - inline-comments
-    description: Documentation, README files, API docs, architecture diagrams, changelogs, migration guides, inline code comments, pitch decks, and blog posts.
-
-  - id: rihal-ahmed
-    name: Ahmed Al Hassani (أحمد الحسني)
-    file_path: rihal/agents/rihal-ahmed.md
-    skill_path: rihal/skills/agents/ahmed-hassani-director
-    role: Technology & Development Director
-    authority_level: strategic
-    domain_keywords:
-      - delivery-plan
-      - engineering-standards
-      - raci
-      - cross-team
-      - dora-metrics
-      - tech-debt-backlog
-      - delivery-timeline
-    description: Bridges CTO vision to executable delivery. Engineering standards, DORA metrics, cross-team coordination.
-
-  - id: rihal-hanzla
-    name: Hanzla (حنظلة)
-    file_path: rihal/agents/rihal-hanzla.md
-    skill_path: rihal/skills/agents/hanzla-engineer
-    role: Senior Full-Stack Engineer
-    authority_level: technical
-    domain_keywords:
-      - implementation
-      - story-execution
-      - code
-      - bug-fix
-      - refactoring
-      - testing
-    description: Story execution, code implementation, bug fixes, refactoring, and hands-on development.
-
-  - id: rihal-omar
-    name: Omar (عمر)
-    file_path: rihal/agents/rihal-omar.md
-    role: Software Engineer
-    authority_level: operational
-    domain_keywords:
-      - implementation
-      - code
-      - pairing
-      - tasks
-      - migrations
-    description: Generalist engineer for implementation tasks spanning frontend and backend. Pairs with Hanzla on complex stories.
-
-  - id: rihal-dalil-scout
-    name: Dalil (دليل)
-    skill_path: rihal/skills/agents/dalil-scout
-    role: Codebase Scout
-    authority_level: analysis
-    domain_keywords:
-      - codebase-discovery
-      - repository-exploration
-      - topic-sweep
-      - architecture-mapping
-      - integrations-audit
-      - project-structure
-    description: Repository discovery, multi-root exploration, focused topic sweeps, and structured codebase documents.
-
-  - id: rihal-raees-orchestrator
-    name: Raees (رئيس)
-    skill_path: rihal/skills/agents/raees-orchestrator
-    role: Project Orchestration Director
-    authority_level: strategic
-    domain_keywords:
-      - orchestration
-      - dispatch
-      - work-routing
-      - phase-sequencing
-      - team-coordination
-      - handoffs
-    description: Dispatches work to the right specialists, sequences phases, identifies parallel vs sequential work, and coordinates handoffs.
-
-  - id: rihal-majlis-council
-    name: Majlis (مجلس)
-    skill_path: rihal/skills/agents/majlis-council
-    role: Multi-Agent Council
-    authority_level: strategic
-    domain_keywords:
-      - council
-      - team-consultation
-      - multi-agent-discussion
-      - crisis-mode
-      - incident-response
-      - cross-domain
-    description: Convenes the Rihal team to discuss any topic, collects perspectives from all relevant specialists, and delivers a synthesised answer with dissent noted.
-
-utility_agents:
-  - id: rihal-planner
-    name: Rihal Planner
-    role: Phase Planning
-    authority_level: operational
-    domain_keywords:
-      - planning
-      - phase-plan
-      - task-breakdown
-    description: Creates detailed implementation plans from scope and context.
-
-  - id: rihal-executor
-    name: Rihal Executor
-    role: Implementation
-    authority_level: operational
-    domain_keywords:
-      - implementation
-      - execution
-      - code-changes
-    description: Executes planned work, commits changes, creates summaries.
-
-  - id: rihal-verifier
-    name: Rihal Verifier
-    role: Quality Verification
-    authority_level: quality
-    domain_keywords:
-      - verification
-      - testing
-      - validation
-    description: Verifies phase completion and checks quality gates.
-
-# Council panel routing rules
-# These rules determine which agents are spawned for different question types.
-# Panel scorer (council-panel.cjs) picks from these based on keyword signals.
-routing:
-  market:
-    - rihal-mariam      # leads
-    - rihal-hussain-pm  # scopes
-    - rihal-sadiq       # kill criteria
-  codebase:
-    - rihal-waleed      # architecture lead
-    - rihal-yousef      # backend implementation
-    - rihal-fatima      # quality gates
-  performance:
-    - rihal-yousef      # backend perf diagnosis owns p50/p95/throughput
-    - rihal-waleed      # architecture-level perf decisions (caching, sharding)
-    - rihal-fatima      # benchmarking + regression guards
-  ml:
-    - rihal-zayd        # ML/OCR/retrieval lead
-    - rihal-yousef      # integration points (queues, APIs)
-    - rihal-fatima      # eval + perf testing
-  frontend:
-    - rihal-haitham     # React/Next.js/RTL implementation
-    - rihal-layla       # UX + interaction design
-    - rihal-fatima      # accessibility + visual regression
-  team:
-    - rihal-sadiq       # leads
-    - rihal-nasser      # people/ops
-  release:
-    - rihal-fatima      # leads
-    - rihal-waleed      # architecture
-    - rihal-khalid      # infra/deploy (if installed)
-  design:
-    - rihal-layla       # UX design lead
-    - rihal-zahra       # branding + visual identity
-    - rihal-waleed      # technical feasibility
-  greenfield:
-    - rihal-mariam      # market
-    - rihal-hussain-pm  # scope
-    - rihal-waleed      # feasibility
-    - rihal-sadiq       # strategic fit
-
-# Tactical / Workflow Agents (spawned by workflows)
-tactical_agents:
-  - id: rihal-advisor-researcher
-    name: Advisor Researcher
-    file_path: rihal/agents/rihal-advisor-researcher.md
-    role: Advisor Researcher
-    authority_level: research
-    description: Advisor-level deep research for gray-area decisions
-
-  - id: rihal-assumptions-analyzer
-    name: Assumptions Analyzer
-    file_path: rihal/agents/rihal-assumptions-analyzer.md
-    role: Assumptions Analyzer
-    authority_level: analysis
-    description: Analyzes phase assumptions with evidence from codebase
-
-  - id: rihal-code-fixer
-    name: Code Fixer
-    file_path: rihal/agents/rihal-code-fixer.md
-    role: Code Fixer
-    authority_level: implementation
-    description: Applies code review findings and implements fixes
-
-  - id: rihal-code-reviewer
-    name: Code Reviewer
-    file_path: rihal/agents/rihal-code-reviewer.md
-    role: Code Reviewer
-    authority_level: quality
-    description: Reviews code for bugs, security issues, quality problems
-
-  - id: rihal-codebase-mapper
-    name: Codebase Mapper
-    file_path: rihal/agents/rihal-codebase-mapper.md
-    role: Codebase Mapper
-    authority_level: analysis
-    description: Explores and documents codebase architecture
-
-  - id: rihal-debugger
-    name: Debugger
-    file_path: rihal/agents/rihal-debugger.md
-    role: Debugger
-    authority_level: implementation
-    description: Investigates bugs using scientific method
-
-  - id: rihal-deviation-analyzer
-    name: Deviation Analyzer
-    file_path: rihal/agents/rihal-deviation-analyzer.md
-    role: Deviation Analyzer
-    authority_level: analysis
-    description: Analyzes plan deviations and root causes
-
-  - id: rihal-docs-auditor
-    name: Docs Auditor
-    file_path: rihal/agents/rihal-docs-auditor.md
-    role: Docs Auditor
-    authority_level: quality
-    description: Audits documentation completeness and accuracy
-
-  - id: rihal-edge-case-hunter
-    name: Edge Case Hunter
-    file_path: rihal/agents/rihal-edge-case-hunter.md
-    role: Edge Case Hunter
-    authority_level: quality
-    description: Enumerates edge cases and boundary conditions
-
-  - id: rihal-executor
-    name: Executor
-    file_path: rihal/agents/rihal-executor.md
-    role: Executor
-    authority_level: implementation
-    description: Executes sprint plans with atomic commits
-
-  - id: rihal-integration-checker
-    name: Integration Checker
-    file_path: rihal/agents/rihal-integration-checker.md
-    role: Integration Checker
-    authority_level: quality
-    description: Verifies cross-phase integration and E2E flows
-
-  - id: rihal-nyquist-auditor
-    name: Nyquist Auditor
-    file_path: rihal/agents/rihal-nyquist-auditor.md
-    role: Nyquist Auditor
-    authority_level: quality
-    description: Fills test coverage gaps for phase requirements
-
-  - id: rihal-phase-researcher
-    name: Phase Researcher
-    file_path: rihal/agents/rihal-phase-researcher.md
-    role: Phase Researcher
-    authority_level: research
-    description: Researches how to implement a phase before planning
-
-  - id: rihal-planner
-    name: Planner
-    file_path: rihal/agents/rihal-planner.md
-    role: Planner
-    authority_level: planning
-    description: Creates executable phase plans with task breakdown
-
-  - id: rihal-profiler
-    name: Profiler
-    file_path: rihal/agents/rihal-profiler.md
-    role: Profiler
-    authority_level: analysis
-    description: Analyzes user behavior patterns and personas
-
-  - id: rihal-project-researcher
-    name: Project Researcher
-    file_path: rihal/agents/rihal-project-researcher.md
-    role: Project Researcher
-    authority_level: research
-    description: Researches domain ecosystem before roadmap creation
-
-  - id: rihal-remediation-planner
-    name: Remediation Planner
-    file_path: rihal/agents/rihal-remediation-planner.md
-    role: Remediation Planner
-    authority_level: planning
-    description: Plans remediation for issues and blockers
-
-  - id: rihal-research-synthesizer
-    name: Research Synthesizer
-    file_path: rihal/agents/rihal-research-synthesizer.md
-    role: Research Synthesizer
-    authority_level: research
-    description: Synthesizes parallel research outputs into summary
-
-  - id: rihal-roadmapper
-    name: Roadmapper
-    file_path: rihal/agents/rihal-roadmapper.md
-    role: Roadmapper
-    authority_level: planning
-    description: Creates project roadmaps with phase breakdown
-
-  - id: rihal-security-adversary
-    name: Security Adversary
-    file_path: rihal/agents/rihal-security-adversary.md
-    role: Security Adversary
-    authority_level: security
-    description: Adversarial security review and threat modeling
-
-  - id: rihal-security-auditor
-    name: Security Auditor
-    file_path: rihal/agents/rihal-security-auditor.md
-    role: Security Auditor
-    authority_level: security
-    description: Comprehensive security audit and compliance verification
-
-  - id: rihal-sprint-checker
-    name: Sprint Checker
-    file_path: rihal/agents/rihal-sprint-checker.md
-    role: Sprint Checker
-    authority_level: quality
-    description: Verifies sprint plans before execution
-
-  - id: rihal-ui-auditor
-    name: UI Auditor
-    file_path: rihal/agents/rihal-ui-auditor.md
-    role: UI Auditor
-    authority_level: quality
-    description: Audits UI for usability and design quality
-
-  - id: rihal-ux-designer
-    name: UX Designer
-    file_path: rihal/agents/rihal-ux-designer.md
-    role: UX Designer
-    authority_level: design
-    description: UX design, accessibility, and design system work
-
-  - id: rihal-verifier
-    name: Verifier
-    file_path: rihal/agents/rihal-verifier.md
-    role: Verifier
-    authority_level: quality
-    description: Verifies phase goal achievement goal-backward
-
-  - id: rihal-i18n-auditor
-    name: i18n Auditor
-    file_path: rihal/agents/rihal-i18n-auditor.md
-    skill_path: rihal/skills/agents/rihal-i18n-auditor
-    role: i18n Auditor
-    authority_level: quality
-    description: Detects hardcoded English strings, missing response_language threading, and RTL layout gaps
-
-  - id: rihal-cross-platform-auditor
-    name: Cross-Platform Auditor
-    file_path: rihal/agents/rihal-cross-platform-auditor.md
-    skill_path: rihal/skills/agents/rihal-cross-platform-auditor
-    role: Cross-Platform Auditor
-    authority_level: quality
-    description: Detects bash-isms, macOS-only flags, hardcoded Unix paths, and CRLF line endings
-
-  - id: rihal-dep-auditor
-    name: Dep Auditor
-    file_path: rihal/agents/rihal-dep-auditor.md
-    skill_path: rihal/skills/agents/rihal-dep-auditor
-    role: Dependency Health Auditor
-    authority_level: quality
-    description: Scans for outdated packages, CVEs, unused dependencies, and loose version pins
-
-  - id: rihal-observability-auditor
-    name: Observability Auditor
-    file_path: rihal/agents/rihal-observability-auditor.md
-    skill_path: rihal/skills/agents/rihal-observability-auditor
-    role: Observability Auditor
-    authority_level: quality
-    description: Detects unguarded shell calls, unchecked Task() results, and missing INIT .ok checks

package/rihal/templates/RESEARCH.md

@@ -1,84 +0,0 @@
-# Phase {{N}} — Research
-
-**Phase:** {{N}} — {{phase_name}}
-**Researcher:** {{user_name}}
-**Date:** {{date}}
-**Status:** Draft
-
----
-
-## Question
-
-What does this phase need to know **before** the planner can write SPRINT.md?
-
-State the central question this RESEARCH.md answers. Keep it tight — one or two sentences. The planner reads this top-down and stops as soon as the question is answered, so do not bury the lede.
-
----
-
-## Sources
-
-Only cite material you actually fetched in this session. WebSearch snippets are not sufficient evidence. See [`@rihal/skills/_shared/research-citation-rule.md`](../skills/_shared/research-citation-rule.md).
-
-| # | Source | Why it matters |
-|---|--------|----------------|
-| 1 | {{url or file path}} | {{one-line reason}} |
-| 2 | | |
-
----
-
-## Findings
-
-Group by sub-question. Each finding should be defensible — link back to a source row above.
-
-### Finding A — {{summary}}
-
-- **Evidence:** [src #1, src #2]
-- **What:** {{two or three sentences max}}
-- **So what:** {{implication for the plan — concrete}}
-
-### Finding B — {{summary}}
-
-- **Evidence:** [src #3]
-- **What:**
-- **So what:**
-
----
-
-## Decisions implied
-
-What does the research force us to decide? List the gray areas the planner now needs to lock down. These become discussion items in CONTEXT.md, not silent assumptions.
-
-- D-1: {{decision name}} — {{options + recommendation if any}}
-- D-2:
-
----
-
-## Out of scope
-
-What did we NOT research and why. Name future work explicitly so it doesn't quietly fall through.
-
-- {{topic}} — {{reason: deferred / blocked on / not needed for this phase}}
-
----
-
-## Open questions
-
-Questions that surfaced during research and stay open. The planner can ask the user, defer to a follow-up, or accept the risk. Don't pretend they are answered.
-
-- Q-1:
-- Q-2:
-
----
-
-## Validation Architecture
-
-<!-- MANDATORY — absence of this section disables Dimension 8 (Nyquist Compliance) in the plan checker. -->
-<!-- If no automated tests are feasible, state that explicitly with a reason. -->
-
-| Concern | Test File | Command | When (Wave) |
-|---------|-----------|---------|-------------|
-| {{feature/requirement}} | {{path/to/test.ts}} | {{run command}} | Wave {{N}} |
-
----
-
-*Phase {{N}} research artifact. Consumed by `rihal-planner` per the [`@.rihal/workflows/plan.md`](../workflows/plan.md) sequence.*