Align agent rules, skills, and workflows; centralize technical standards

Author: wayangalihpratama

.agent/rules/PROJECT_RULES.md

@@ -1,7 +1,11 @@
-# IDH-IDC Project Rules for AI Agents
-
 These rules define the technical standards, design patterns, and workflow requirements for the IDH-IDC project. All AI agents MUST follow these guidelines to ensure consistency and quality.
 
+## 0. Agent Asset Hierarchy
+To maintain alignment across agent resources, we follow this structural hierarchy:
+1. **Rules** (`.agent/rules/`): **The Law.** Universal technical standards, design constraints, and mandatory procedures.
+2. **Skills** (`.agent/skills/`): **Technical Knowledge.** Deep domain expertise and situational knowledge for specific subsystems.
+3. **Workflows** (`.agent/workflows/`): **Recipes.** Actionable, step-by-step procedures for common tasks (e.g., slash commands).
+
 ## 1. Core Technology Stack
 
 - **Frontend**: React (Create React App), Ant Design, echarts, pullstate.

.agent/skills/idc-core/SKILL.md

@@ -7,11 +7,7 @@ description: Core technology stack, environment setup, and basic usage for IDH-I
 
 General technical information and basic environment operations for the IDH-IDC project.
 
-## Technology Stack
-
-- **Backend**: FastAPI (Python), SQLAlchemy, Alembic, Pytest
-- **Frontend**: React (CRA), Ant Design, Pullstate, Jest
-- **Infra**: Docker, Docker Compose, Kubernetes
+Note: For the detailed technical standards and tech stack requirements, refer to [.agent/rules/PROJECT_RULES.md](file:///Users/galihpratama/Sites/IDH-IDC/.agent/rules/PROJECT_RULES.md).
 
 ## Environment Setup
 

.agent/skills/idc-database/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: idc-database
-description: Database management, seeding, and migrations for IDH-IDC.
+description: Database management, seeding, and migrations for IDH-IDC. Refer to `/seed_data` workflow for step-by-step seeding instructions.
 ---
 
 # IDC Database Skills

.agent/skills/idc-testing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: idc-testing
-description: Testing and linting for IDH-IDC backend and frontend.
+description: Testing and linting for IDH-IDC backend and frontend. Use `/run_frontend_lint`, `/run_backend_test`, and `/run_frontend_test` for automated verification.
 ---
 
 # IDC Testing Skills

.agent/workflows/plan_implementation.md

@@ -9,16 +9,7 @@ description: Create a comprehensive implementation plan for a feature or bug fix
    - **Goal**: Brief summary of the problem and what the change accomplishes.
    - **User Review Required**: Highlight breaking changes or design decisions.
    - **Proposed Changes**: Detailed breakdown by file.
-     - **Frontend Standards**:
-       - **Framework**: React (Functional Components + Hooks).
-       - **UI Library**: Ant Design (antd).
-       - **State Management**: Pullstate.
-       - **Linting**: Must pass `docker compose exec frontend yarn lint` (ESLint).
-       - **Testing**: `docker compose exec frontend yarn test:ci` or interactive `yarn test`.
-     - **Backend Standards**:
-       - **Framework**: FastAPI (Python).
-       - **Database**: SQLAlchemy + Alembic migrations.
-       - **Linting/Testing**: Must pass `./dc.sh exec backend ./check.sh` (includes `flake8` and `pytest`).
+      - **Technical Standards**: All changes MUST strictly adhere to the technical standards and best practices defined in [.agent/rules/PROJECT_RULES.md](file:///Users/galihpratama/Sites/IDH-IDC/.agent/rules/PROJECT_RULES.md).
    - **Verification Plan**:
      - **Automated**: List specific commands to run (e.g., `yarn lint`, `./check.sh`).
      - **Manual**: Step-by-step browser verification instructions.

.agent/workflows/run_frontend_lint.md

@@ -3,4 +3,4 @@ description: Run frontend linting using docker compose
 ---
 1. Run the lint command
 // turbo
-docker compose exec frontend yarn lint
+./dc.sh exec frontend yarn lint

GEMINI.md

@@ -188,6 +188,11 @@ Income Driver Calculator (IDC) is a web application designed to help companies t
 - **Technical Improvements & Workflows**:
     - **General Refactoring**: Split the monolithic `idc-antigravity-skills` into granular components: `idc-core`, `idc-database`, and `idc-testing`.
     - **Workflows**: Updated `check_time`, `commit_changes`, and `create_pr` workflows with automated branch detection; implemented `seed_data`, `view_logs`, and `run_frontend_test`.
+    - **Asset Alignment & Centralized Rules**:
+        - Unified Rules, Skills, and Workflows into a cohesive hierarchy (The Law > Knowledge > Recipes).
+        - Standardized all container commands to use `./dc.sh` wrapper for consistency.
+        - Streamlined workflows by centralizing technical standards in `PROJECT_RULES.md`.
+        - Added cross-references between specialized skills and actionable workflows.
     - **Project Rules Implementation**:
         - Created comprehensive `.agent/rules/PROJECT_RULES.md` defining FE/BE coding standards and best practices.
         - Implemented technical linting rules (e.g., `exhaustive-deps`, `jsx-a11y`) and performance patterns (e.g., `useMemo`, `pullstate` functional updates).