sdcorejs-agent

SDCoreJS

An orchestrated SDLC for AI coding agents. Works in Claude Code, GitHub Copilot, and Codex.

SDCoreJS turns Claude Code, GitHub Copilot, and Codex into accountable engineers on your stack. Requests flow through clarify → spec → plan → write code → review → ship, with user-approval gates between each phase and a documented audit trail.

Three first-class tracks, each with stack-specific conventions, generators, reviews, and tests:

• Angular Portal — backoffice portals built on @sd-angular/core (Core UI)
• NestJS — modular APIs with Postgres + DTOs + permissions
• Next.js — public sites with bilingual content, SEO, ISR caching

The system ships as dispatchable skills — markdown with YAML frontmatter — that AI coding tools match against intent and execute in order. No runtime, no CLI, no compiler; just the workflow layer your AI coding tool was missing.

How it works

1. You clone or attach this repo's skills/ and entry-point files (CLAUDE.md, AGENTS.md, .github/copilot-instructions.md, .github/chatmodes/sdcorejs.chatmode.md) to your target project.
2. The AI tool reads the entry-point at session start.
3. When you ask the tool to do something ("tạo entity product", "review module catalog"), it matches your request against each skill's description and follows the matched skill's instructions exactly.

Tracks

Track	Path	Status
Angular Portal	skills/angular-portal/	✅ Complete (21 skills + 58 reference docs for Core UI)
NestJS	skills/nestjs/	🚧 Planned
Next.js	skills/nextjs/	🚧 Planned

Workflow (per track)

Every track follows the same SDLC pipeline. Numbering reflects the order.

Request
  ↓
00-onboarding              ← orient the developer
01-brainstorm              ← explore requirements open-ended
02-clarify-requirements    ← hard-confirm scope (blocking questions)
03-write-spec              ← author a spec document
04-review-spec             ← user reviews + approves spec
05-plan                    ← step-by-step plan
06-review-plan             ← user reviews + approves plan
07-write-code              ← orchestrator that dispatches sub-skills (10-31)
40-e2e-test                ← write E2E tests for what was built
50-review-code             ← self-review against conventions
orchestration/comment-code ← MANDATORY ASK gate: skip / simple / medium / full (all applied inline)
  ↓
orchestration/auto-docs    ← MANDATORY: summary to target project's .sdcorejs/docs/<track>/
orchestration/memories     ← when learning durable knowledge: target project's .sdcorejs/memories/<track>/

Sub-skills under 07-write-code (Angular Portal): 10-init-portal, 11-init-module, 12-init-entity, 20-screen-list, 21-screen-detail (CREATE / UPDATE / DETAIL states + reactive-form refinement), 31-actions (workflow / bulk / custom side-effects).

Mandatory rules (every track)

1. Auto-docs at the end of every code-writing task → writes to your target project's .sdcorejs/docs/<track>/<YYYY-MM-DD-HH-mm>-<topic>.md. Read at session start to recall prior work.
2. Memories when the agent learns durable knowledge (a convention, a stakeholder constraint, an anti-pattern) → writes to target project's .sdcorejs/memories/<track>/<topic>.md. Indexed at session start.
3. Bilingual — Vietnamese request → Vietnamese output (full diacritics). English → English. Permission codes + route paths stay English.
4. Clarify-before-code — agent refuses to generate code without module ownership / entity name / key fields.
5. Core UI first (Angular Portal) — use @sd-angular/core components; otherwise skeleton + alert('TODO: ...') stubs.
6. Test after generation — run framework tests and report.

Quick start in a target project

Option 1 — Claude Code plugin (recommended for Claude Code users)

Install via the Claude Code plugin marketplace. The repo ships its own single-plugin marketplace at .claude-plugin/marketplace.json, so you only need to add the repo as a marketplace and install the plugin:

/plugin marketplace add sdcorejs/sdcorejs-agent
/plugin install sdcorejs-agent@sdcorejs

After install, all 76 skills (cross-track SDLC + angular-portal / nestjs / nextjs tracks + orchestration + review + testing) are dispatched automatically by Claude Code based on each skill's description trigger.

Option 2 — git submodule (works for Claude Code + Copilot + Codex)

cd <your-portal-project>
git submodule add <repo-url> .sdcorejs-agent
ln -s .sdcorejs-agent/CLAUDE.md CLAUDE.md
ln -s .sdcorejs-agent/AGENTS.md AGENTS.md
ln -s .sdcorejs-agent/skills skills-sdcorejs

Option 3 — copy entry points + skills

cp -r <agent-repo>/{CLAUDE.md,AGENTS.md,skills} ./

Then open the project in Claude Code / Copilot / Codex and start describing what you want.

Tool support priority