Skip to content
custom-project-standards logo

Custom Project Standard Platform (v2.1)

custom-project-standards

Hệ thống tiêu chuẩn dự án đa năng (Standard Platform). Hỗ trợ Frontend, Backend, DevOps với nhiều tùy chọn ngôn ngữ/framework.

SKILL.md

Full skill instructions

Custom Project Standard Platform (v2.1)

OPERATING MECHANISM:

  1. Auto-Config: Checks for agent-project-config.md in the workspace root. If found, loads Context/​Role from there.
  2. Wizard Mode: If NO config file is found, asks the User to determine Context & Stack.

1. Setup & Context Protocol (Configuration Protocol)

Step 0: Check Config (Highest Priority)

Before asking the user, search for the agent-project-config.md file in the root directory.

If found: Read the Frontmatter of the file to determine:

  • project_type -> Determine Domain (Frontend/​Backend...)
  • tech_stack -> Determine Stack (NestJS/​NextJS...)
  • role_mode -> Determine Persona (Architect/​Implementer...)

Note: If Config exists, SKIP Steps 1 and 2 below, proceed directly to Step 3 (Load Context).

If NOT found: Execute "Wizard" mode (Steps 1 & 2), then propose the user to create a config file for future sessions.

Step 0.5: Analyze Environment (Existing Codebase Protocol)

Before applying any rigid rules or installing new packages, the Agent MUST READ the dependency management files (package.json, go.mod, composer.json, requirements.txt).

Principles:

  1. Respect Legacy: If the project already uses a specific library (e.g., TypeORM instead of Prisma), USE IT. Do not suggest switching unless explicitly requested.
  2. Kit Default: Only recommend the Kit's preferred packages (from tech-stack.md) if the project is brand new or lacks that specific capability.

Step 1: Determine Project Type (Domain) - Wizard Mode

Ask the User or auto-detect:

  • Frontend
  • Backend
  • DevOps

Step 2: Determine Language/​Framework (Stack) - Wizard Mode

Based on the Domain, further determine:

  • Frontend: Next.js | Vue | React Native
  • Backend: NestJS | Python (FastAPI) | Go | Laravel
  • DevOps: Docker | K8s | AWS

Step 3: Load Context (Important)

After determination (via Config or Wizard), the Agent MUST READ the following documents in order:

  1. Core Principles (Global): rules/​standards/​design-principles.md (MUST READ FIRST)
  2. Domain Rules: (e.g., rules/​backend/​general.md)
  3. Stack Rules: (e.g., rules/​backend/​nestjs/​convention.md)
  4. Role Mode (If available): (e.g., rules/​roles/​architect.md)

💡 Example: Config is Backend + NestJS: -> Agent reads rules/​standards/​design-principles.md -> Agent reads rules/​backend/​general.md -> Agent reads rules/​backend/​nestjs/​convention.md


2. Rules Map

🎨 Frontend

StackRule FileTemplate
Generalrules/​frontend/​general.md-
Next.jsrules/​frontend/​nextjs/​convention.mdtemplates/​frontend/​nextjs/
Vue/​Nuxtrules/​frontend/​vue/​convention.mdtemplates/​frontend/​vue/

⚙️ Backend

StackRule FileTemplate
Generalrules/​backend/​general.md-
NestJSrules/​backend/​nestjs/​convention.mdtemplates/​backend/​nestjs/
Laravelrules/​backend/​laravel/​convention.md-
Gorules/​backend/​go/​convention.md-
Pythonrules/​backend/​python/​convention.mdtemplates/​backend/​python/

🚀 DevOps

StackRule File
Dockerrules/​devops/​docker-standard.md
CI/​CDrules/​devops/​cicd-standard.md

3. Installation Guide

In case the User requests "Create a new project", follow these steps:

  1. Ask User: "Do you want to create a Frontend or Backend project? Which language?"
  2. Confirm: "I will create a Next.js project following Custom Standard v2."
  3. Execute:
    • Copy structure from templates/​frontend/​nextjs/ (if available)
    • Create README.md with content from rules/​frontend/​nextjs/​convention.md
    • Install required dependencies (check tech-stack.md in the subfolder).