create-task-ops 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# create-task-ops
+
+`Next.js` 고정 기반의 task-ops 스캐폴드 생성기다.
+
+## 목표
+
+- 새 리포를 빠르게 시작
+- 기존 리포에 task-ops 구조 주입
+- `tasks/*.md` 와 Task API 계약을 기본으로 포함
+
+## 모드
+
+- `full`
+  Next.js 앱, 기본 대시보드 페이지, Task API, tasks 문서 포함
+- `api`
+  Next.js 앱, Task API 중심, 최소 페이지 포함
+- `docs`
+  `tasks/`, `CLAUDE.md`, `AGENT.md`, 계약 문서만 포함
+
+## 사용 예시
+
+```bash
+node packages/create-task-ops/bin/create-task-ops.js my-project
+node packages/create-task-ops/bin/create-task-ops.js my-project --mode api
+node packages/create-task-ops/bin/create-task-ops.js --init --mode docs
+```
+
+publish 후에는 아래처럼 쓸 수 있게 설계했다.
+
+```bash
+npx create-task-ops my-project
+npx create-task-ops my-project --mode api
+npx create-task-ops --init --mode docs
+```
+
+## 로컬 테스트
+
+```bash
+npm run create-task-ops -- my-project
+npm run create-task-ops -- --init --mode docs
+cd packages/create-task-ops
+npm run smoke:full
+```
+
+## 퍼블리시 전 체크
+
+```bash
+cd packages/create-task-ops
+npm run smoke:docs
+npm run pack:dry-run
+```
+
+## 배포 전 수동 확인
+
+- `npm view create-task-ops name`
+- `npm whoami`
+- `npm version patch | minor | major`
+- `npm publish --access public`
+
+만약 로컬 npm 캐시 권한 문제가 있으면 `pack:dry-run` 처럼 임시 캐시를 쓰는 편이 안전하다.

package/bin/create-task-ops.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+const args = process.argv.slice(2);
+const repoRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), "../../..");
+const templatesRoot = path.join(repoRoot, "packages/create-task-ops/templates");
+
+function parseArgs(argv) {
+  const options = {
+    name: null,
+    mode: "full",
+    init: false,
+    force: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--mode") {
+      options.mode = argv[index + 1] ?? "full";
+      index += 1;
+      continue;
+    }
+    if (arg === "--init") {
+      options.init = true;
+      continue;
+    }
+    if (arg === "--force") {
+      options.force = true;
+      continue;
+    }
+    if (!arg.startsWith("--") && !options.name) {
+      options.name = arg;
+    }
+  }
+
+  return options;
+}
+
+function ensureMode(mode) {
+  if (!["full", "api", "docs"].includes(mode)) {
+    console.error(`Unsupported mode: ${mode}`);
+    process.exit(1);
+  }
+}
+
+function listFiles(dir, prefix = "") {
+  const entries = readdirSync(dir);
+  return entries.flatMap((entry) => {
+    const absolute = path.join(dir, entry);
+    const relative = path.join(prefix, entry);
+    if (statSync(absolute).isDirectory()) {
+      return listFiles(absolute, relative);
+    }
+    return [relative];
+  });
+}
+
+function renderTemplate(content, projectName) {
+  return content.replaceAll("__PROJECT_NAME__", projectName);
+}
+
+function copyTemplateTree(sourceDir, targetDir, projectName, force) {
+  mkdirSync(targetDir, { recursive: true });
+  const files = listFiles(sourceDir);
+
+  for (const relativeFile of files) {
+    const sourcePath = path.join(sourceDir, relativeFile);
+    const targetPath = path.join(targetDir, relativeFile);
+    const targetFolder = path.dirname(targetPath);
+    mkdirSync(targetFolder, { recursive: true });
+
+    if (existsSync(targetPath) && !force) {
+      console.error(`Refusing to overwrite existing file: ${targetPath}`);
+      console.error("Use --force if you want to replace scaffolded files.");
+      process.exit(1);
+    }
+
+    const content = readFileSync(sourcePath, "utf8");
+    writeFileSync(targetPath, renderTemplate(content, projectName), "utf8");
+  }
+}
+
+function main() {
+  const options = parseArgs(args);
+  ensureMode(options.mode);
+
+  const inferredName = options.name ? path.basename(path.resolve(process.cwd(), options.name)) : path.basename(process.cwd());
+  const projectName = inferredName || "task-ops-project";
+  const targetDir = options.init
+    ? process.cwd()
+    : path.resolve(process.cwd(), options.name ?? projectName);
+
+  if (!options.init && existsSync(targetDir) && readdirSync(targetDir).length > 0 && !options.force) {
+    console.error(`Target directory is not empty: ${targetDir}`);
+    console.error("Use --force if you want to write scaffold files there.");
+    process.exit(1);
+  }
+
+  mkdirSync(targetDir, { recursive: true });
+
+  const commonDir = path.join(templatesRoot, "common");
+  const modeDir = path.join(templatesRoot, options.mode);
+
+  copyTemplateTree(commonDir, targetDir, projectName, options.force);
+  copyTemplateTree(modeDir, targetDir, projectName, options.force);
+
+  console.log(`create-task-ops completed`);
+  console.log(`target: ${targetDir}`);
+  console.log(`mode: ${options.mode}`);
+  console.log(`project: ${projectName}`);
+  console.log(`next steps:`);
+  console.log(`1. cd ${options.init ? "." : projectName}`);
+  if (options.mode !== "docs") {
+    console.log(`2. npm install`);
+    console.log(`3. npm run dev`);
+  } else {
+    console.log(`2. create real task files under tasks/`);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "create-task-ops",
+  "version": "0.1.0",
+  "description": "Next.js-first task-ops scaffold generator for task docs and task APIs",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "bin",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "create-task-ops": "./bin/create-task-ops.js"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "keywords": [
+    "nextjs",
+    "scaffold",
+    "generator",
+    "tasks",
+    "dashboard",
+    "llm",
+    "agents"
+  ],
+  "scripts": {
+    "pack:dry-run": "npm_config_cache=/tmp/npm-cache npm pack --dry-run",
+    "smoke:full": "node ./bin/create-task-ops.js /tmp/create-task-ops-full --mode full --force",
+    "smoke:api": "node ./bin/create-task-ops.js /tmp/create-task-ops-api --mode api --force",
+    "smoke:docs": "node ./bin/create-task-ops.js /tmp/create-task-ops-docs --mode docs --force",
+    "prepublishOnly": "npm run smoke:docs && npm run pack:dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/api/app/api/health/route.ts

@@ -0,0 +1,12 @@
+import { NextResponse } from "next/server";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+  return NextResponse.json({
+    ok: true,
+    service: "__PROJECT_NAME__-task-api",
+    updatedAt: new Date().toISOString(),
+  });
+}

package/templates/api/app/api/tasks/[id]/route.ts

@@ -0,0 +1,25 @@
+import { NextResponse } from "next/server";
+import { getTaskById } from "@/lib/task-api";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+export async function GET(
+  _request: Request,
+  context: { params: Promise<{ id: string }> },
+) {
+  const { id } = await context.params;
+  const task = await getTaskById(id);
+
+  if (!task) {
+    return NextResponse.json({ error: "Task not found" }, { status: 404 });
+  }
+
+  return NextResponse.json({
+    source: {
+      id: "__PROJECT_NAME__",
+      label: "__PROJECT_NAME__",
+    },
+    task,
+  });
+}

package/templates/api/app/api/tasks/route.ts

@@ -0,0 +1,17 @@
+import { NextResponse } from "next/server";
+import { getTasks } from "@/lib/task-api";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+  const tasks = await getTasks();
+
+  return NextResponse.json({
+    source: {
+      id: "__PROJECT_NAME__",
+      label: "__PROJECT_NAME__",
+    },
+    tasks,
+  });
+}

package/templates/api/app/globals.css

@@ -0,0 +1,10 @@
+html,
+body {
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  background: #f6f2eb;
+  color: #20160f;
+}

package/templates/api/app/layout.tsx

@@ -0,0 +1,13 @@
+import "./globals.css";
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="ko">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/api/app/page.tsx

@@ -0,0 +1,8 @@
+export default function Home() {
+  return (
+    <main style={{ padding: 32, fontFamily: "sans-serif" }}>
+      <h1>__PROJECT_NAME__ Task API</h1>
+      <p>`/api/health`, `/api/tasks`, `/api/tasks/:id` 를 통해 중앙 대시보드와 연동한다.</p>
+    </main>
+  );
+}

package/templates/api/lib/task-api.ts

@@ -0,0 +1,110 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+
+type TaskStatus = "running" | "blocked" | "idle" | "queued" | "completed" | "failed";
+
+type TaskRecord = {
+  id: string;
+  title: string;
+  status: TaskStatus;
+  progress: number;
+  progressNote: string;
+  priority: string;
+  owner: string;
+  agent: string;
+  lastUpdated: string;
+  goal: string;
+  currentState: string[];
+  completed: string[];
+  remaining: string[];
+  blockers: string[];
+  nextAction: string;
+};
+
+const tasksDir = path.join(process.cwd(), "tasks");
+const sectionNames = [
+  "Metadata",
+  "Goal",
+  "Progress Model",
+  "Current State",
+  "Completed",
+  "Remaining",
+  "Blockers",
+  "Next Action",
+  "Notes",
+] as const;
+
+function parseSection(markdown: string, heading: (typeof sectionNames)[number]) {
+  const names = sectionNames.join("|");
+  const pattern = new RegExp(`## ${heading}\\n([\\s\\S]*?)(?=\\n## (${names})\\n|$)`);
+  const match = markdown.match(pattern);
+  return match?.[1]?.trim() ?? "";
+}
+
+function parseKeyValueSection(section: string) {
+  return Object.fromEntries(
+    section
+      .split("\n")
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .map((line) => line.replace(/^- /, ""))
+      .map((line) => {
+        const index = line.indexOf(":");
+        if (index === -1) {
+          return [line, ""];
+        }
+        return [line.slice(0, index).trim(), line.slice(index + 1).trim()];
+      }),
+  );
+}
+
+function parseList(section: string) {
+  return section
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => line.replace(/^[-*] /, "").replace(/^\[[ x]\] /, ""));
+}
+
+function parseTitle(markdown: string) {
+  const match = markdown.match(/^# Task: (.+)$/m);
+  return match?.[1]?.trim() ?? "Untitled Task";
+}
+
+export async function getTasks(): Promise<TaskRecord[]> {
+  const entries = await readdir(tasksDir, { withFileTypes: true });
+  const taskFiles = entries.filter((entry) => entry.isFile() && entry.name.endsWith(".md"));
+
+  return Promise.all(
+    taskFiles.map(async (entry) => {
+      const fullPath = path.join(tasksDir, entry.name);
+      const markdown = await readFile(fullPath, "utf8");
+      const metadata = parseKeyValueSection(parseSection(markdown, "Metadata"));
+      const progressModel = parseKeyValueSection(parseSection(markdown, "Progress Model"));
+      const progress = Number.parseInt(progressModel.Progress ?? "0", 10);
+
+      return {
+        id: entry.name.replace(/\.md$/, ""),
+        title: parseTitle(markdown),
+        status: (metadata.Status ?? "idle") as TaskStatus,
+        progress: Number.isNaN(progress) ? 0 : progress,
+        progressNote: `${progressModel["Completed Checkpoints"] ?? "0"}/${progressModel["Total Checkpoints"] ?? "0"} checkpoints`,
+        priority: metadata.Priority ?? "medium",
+        owner: metadata.Owner ?? "Unassigned",
+        agent: metadata.Agent ?? "unknown",
+        lastUpdated: metadata["Last Updated"] ?? "",
+        goal: parseSection(markdown, "Goal"),
+        currentState: parseList(parseSection(markdown, "Current State")),
+        completed: parseList(parseSection(markdown, "Completed")),
+        remaining: parseList(parseSection(markdown, "Remaining")),
+        blockers: parseList(parseSection(markdown, "Blockers")),
+        nextAction: parseSection(markdown, "Next Action"),
+      };
+    }),
+  );
+}
+
+export async function getTaskById(id: string) {
+  const tasks = await getTasks();
+  return tasks.find((task) => task.id === id) ?? null;
+}

package/templates/api/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/api/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+};
+
+export default nextConfig;

package/templates/api/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "15.2.4",
+    "react": "19.0.0",
+    "react-dom": "19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.10",
+    "@types/react": "19.0.10",
+    "@types/react-dom": "19.0.4",
+    "typescript": "5.8.2"
+  }
+}

package/templates/api/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/common/AGENT.md

@@ -0,0 +1,15 @@
+# AGENT.md
+
+## Agent Checklist
+
+1. 관련 `tasks/*.md` 확인
+2. `Status`, `Progress Model`, `Current State`, `Next Action` 확인
+3. 작업 진행
+4. 의미 있는 체크포인트마다 task 갱신
+5. handoff 전 task 최신화
+
+## Progress Standard
+
+- `Progress` 는 체크포인트 기반으로 기록한다.
+- `Current State` 는 지금 사실인 상태를 쓴다.
+- `Next Action` 은 다음 세션이 바로 실행할 수 있어야 한다.

package/templates/common/CLAUDE.md

@@ -0,0 +1,24 @@
+# CLAUDE.md
+
+## Task-First Rule
+
+- 이 리포의 작업 상태는 `tasks/*.md` 가 기준이다.
+- 새 Claude 세션은 작업 시작 전에 관련 task 파일을 먼저 읽는다.
+- 코드 변경, 테스트 결과, blocker 변화가 생기면 task 파일을 즉시 갱신한다.
+
+## Required Sections
+
+- `Metadata`
+- `Goal`
+- `Progress Model`
+- `Current State`
+- `Completed`
+- `Remaining`
+- `Blockers`
+- `Next Action`
+- `Notes`
+
+## Handoff Requirement
+
+- 다음 세션이 chat history 없이도 `tasks/*.md` 만 보고 이어받을 수 있어야 한다.
+- handoff 전에 `Status`, `Progress`, `Current State`, `Blockers`, `Next Action`, `Last Updated` 를 최신으로 맞춘다.

package/templates/common/docs/TASK_API_CONTRACT.md

@@ -0,0 +1,32 @@
+# Task API Contract
+
+중앙 대시보드가 외부 리포를 읽기 위해 기대하는 최소 계약이다.
+
+## Endpoints
+
+- `GET /api/health`
+- `GET /api/tasks`
+- `GET /api/tasks/:id`
+
+## Task Fields
+
+- `id`
+- `title`
+- `status`
+- `progress`
+- `progressNote`
+- `priority`
+- `owner`
+- `agent`
+- `lastUpdated`
+- `goal`
+- `currentState`
+- `completed`
+- `remaining`
+- `blockers`
+- `nextAction`
+
+## Notes
+
+- `tasks/*.md` 가 1차 진실 소스다.
+- API는 그 문서를 읽어 중앙 대시보드에 노출하기 위한 계층이다.

package/templates/common/tasks/example-task.md

@@ -0,0 +1,38 @@
+# Task: __PROJECT_NAME__ Example Task
+
+## Metadata
+- Owner: Core Team
+- Agent: codex
+- Status: running
+- Progress: 25%
+- Priority: high
+- Last Updated: 2026-04-09T10:00:00+09:00
+
+## Goal
+이 리포에서 task-ops 운영 구조를 정착시키고 첫 작업 흐름을 검증한다.
+
+## Progress Model
+- Total Checkpoints: 4
+- Completed Checkpoints: 1
+- Progress: 25%
+
+## Current State
+- task-ops scaffold 가 배치되었다
+- 첫 task 문서가 생성되었다
+
+## Completed
+- [x] scaffold 생성
+
+## Remaining
+- [ ] 실제 프로젝트 task 생성
+- [ ] API source id와 label 확정
+- [ ] 중앙 대시보드 등록
+
+## Blockers
+- None
+
+## Next Action
+현재 프로젝트에 맞는 실제 작업 파일로 example task를 대체한다.
+
+## Notes
+- 생성 직후에는 source metadata 를 팀 규약에 맞게 바꾼다.

package/templates/docs/README.md

@@ -0,0 +1,16 @@
+# __PROJECT_NAME__
+
+Task-ops 문서 모드로 생성된 프로젝트다.
+
+## 포함 항목
+
+- `tasks/`
+- `CLAUDE.md`
+- `AGENT.md`
+- `docs/TASK_API_CONTRACT.md`
+
+## 다음 단계
+
+1. `tasks/example-task.md` 를 실제 작업으로 교체
+2. 리포 규약에 맞게 `CLAUDE.md`, `AGENT.md` 조정
+3. 필요해지면 Next.js Task API를 추가

package/templates/full/app/api/health/route.ts

@@ -0,0 +1,12 @@
+import { NextResponse } from "next/server";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+  return NextResponse.json({
+    ok: true,
+    service: "__PROJECT_NAME__-task-api",
+    updatedAt: new Date().toISOString(),
+  });
+}

package/templates/full/app/api/tasks/[id]/route.ts

@@ -0,0 +1,25 @@
+import { NextResponse } from "next/server";
+import { getTaskById } from "@/lib/task-api";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+export async function GET(
+  _request: Request,
+  context: { params: Promise<{ id: string }> },
+) {
+  const { id } = await context.params;
+  const task = await getTaskById(id);
+
+  if (!task) {
+    return NextResponse.json({ error: "Task not found" }, { status: 404 });
+  }
+
+  return NextResponse.json({
+    source: {
+      id: "__PROJECT_NAME__",
+      label: "__PROJECT_NAME__",
+    },
+    task,
+  });
+}

package/templates/full/app/api/tasks/route.ts

@@ -0,0 +1,17 @@
+import { NextResponse } from "next/server";
+import { getTasks } from "@/lib/task-api";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+  const tasks = await getTasks();
+
+  return NextResponse.json({
+    source: {
+      id: "__PROJECT_NAME__",
+      label: "__PROJECT_NAME__",
+    },
+    tasks,
+  });
+}

package/templates/full/app/globals.css

@@ -0,0 +1,48 @@
+body {
+  margin: 0;
+  background: #f6f2eb;
+  color: #20160f;
+  font-family: Georgia, "Times New Roman", serif;
+}
+
+.page-shell {
+  min-height: 100vh;
+  padding: 40px 20px;
+}
+
+.hero,
+.task-grid {
+  width: min(960px, 100%);
+  margin: 0 auto;
+}
+
+.hero {
+  margin-bottom: 24px;
+}
+
+.hero-card,
+.task-card {
+  border: 1px solid rgba(91, 64, 34, 0.14);
+  border-radius: 24px;
+  background: rgba(255, 250, 242, 0.92);
+  padding: 24px;
+}
+
+.eyebrow {
+  color: #d46a32;
+  font-size: 0.78rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.12em;
+}
+
+.task-grid {
+  display: grid;
+  gap: 16px;
+}
+
+.task-head {
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+}

package/templates/full/app/layout.tsx

@@ -0,0 +1,13 @@
+import "./globals.css";
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="ko">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/full/app/page.tsx

@@ -0,0 +1,37 @@
+async function getTasks() {
+  const baseUrl = process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000";
+  const response = await fetch(`${baseUrl}/api/tasks`, { cache: "no-store" }).catch(() => null);
+  if (!response?.ok) {
+    return [];
+  }
+  const payload = (await response.json()) as { tasks?: Array<{ id: string; title: string; status: string; progress: number; nextAction: string }> };
+  return payload.tasks ?? [];
+}
+
+export default async function Home() {
+  const tasks = await getTasks();
+
+  return (
+    <main className="page-shell">
+      <section className="hero">
+        <div className="hero-card">
+          <span className="eyebrow">Task Ops</span>
+          <h1>__PROJECT_NAME__</h1>
+          <p>이 프로젝트는 task-first 운영 구조와 Next.js 기반 Task API를 기본으로 시작한다.</p>
+        </div>
+      </section>
+      <section className="task-grid">
+        {tasks.map((task) => (
+          <article className="task-card" key={task.id}>
+            <div className="task-head">
+              <strong>{task.title}</strong>
+              <span>{task.status}</span>
+            </div>
+            <p>{task.progress}%</p>
+            <small>{task.nextAction}</small>
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/full/lib/task-api.ts

@@ -0,0 +1,110 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+
+type TaskStatus = "running" | "blocked" | "idle" | "queued" | "completed" | "failed";
+
+type TaskRecord = {
+  id: string;
+  title: string;
+  status: TaskStatus;
+  progress: number;
+  progressNote: string;
+  priority: string;
+  owner: string;
+  agent: string;
+  lastUpdated: string;
+  goal: string;
+  currentState: string[];
+  completed: string[];
+  remaining: string[];
+  blockers: string[];
+  nextAction: string;
+};
+
+const tasksDir = path.join(process.cwd(), "tasks");
+const sectionNames = [
+  "Metadata",
+  "Goal",
+  "Progress Model",
+  "Current State",
+  "Completed",
+  "Remaining",
+  "Blockers",
+  "Next Action",
+  "Notes",
+] as const;
+
+function parseSection(markdown: string, heading: (typeof sectionNames)[number]) {
+  const names = sectionNames.join("|");
+  const pattern = new RegExp(`## ${heading}\\n([\\s\\S]*?)(?=\\n## (${names})\\n|$)`);
+  const match = markdown.match(pattern);
+  return match?.[1]?.trim() ?? "";
+}
+
+function parseKeyValueSection(section: string) {
+  return Object.fromEntries(
+    section
+      .split("\n")
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .map((line) => line.replace(/^- /, ""))
+      .map((line) => {
+        const index = line.indexOf(":");
+        if (index === -1) {
+          return [line, ""];
+        }
+        return [line.slice(0, index).trim(), line.slice(index + 1).trim()];
+      }),
+  );
+}
+
+function parseList(section: string) {
+  return section
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => line.replace(/^[-*] /, "").replace(/^\[[ x]\] /, ""));
+}
+
+function parseTitle(markdown: string) {
+  const match = markdown.match(/^# Task: (.+)$/m);
+  return match?.[1]?.trim() ?? "Untitled Task";
+}
+
+export async function getTasks(): Promise<TaskRecord[]> {
+  const entries = await readdir(tasksDir, { withFileTypes: true });
+  const taskFiles = entries.filter((entry) => entry.isFile() && entry.name.endsWith(".md"));
+
+  return Promise.all(
+    taskFiles.map(async (entry) => {
+      const fullPath = path.join(tasksDir, entry.name);
+      const markdown = await readFile(fullPath, "utf8");
+      const metadata = parseKeyValueSection(parseSection(markdown, "Metadata"));
+      const progressModel = parseKeyValueSection(parseSection(markdown, "Progress Model"));
+      const progress = Number.parseInt(progressModel.Progress ?? "0", 10);
+
+      return {
+        id: entry.name.replace(/\.md$/, ""),
+        title: parseTitle(markdown),
+        status: (metadata.Status ?? "idle") as TaskStatus,
+        progress: Number.isNaN(progress) ? 0 : progress,
+        progressNote: `${progressModel["Completed Checkpoints"] ?? "0"}/${progressModel["Total Checkpoints"] ?? "0"} checkpoints`,
+        priority: metadata.Priority ?? "medium",
+        owner: metadata.Owner ?? "Unassigned",
+        agent: metadata.Agent ?? "unknown",
+        lastUpdated: metadata["Last Updated"] ?? "",
+        goal: parseSection(markdown, "Goal"),
+        currentState: parseList(parseSection(markdown, "Current State")),
+        completed: parseList(parseSection(markdown, "Completed")),
+        remaining: parseList(parseSection(markdown, "Remaining")),
+        blockers: parseList(parseSection(markdown, "Blockers")),
+        nextAction: parseSection(markdown, "Next Action"),
+      };
+    }),
+  );
+}
+
+export async function getTaskById(id: string) {
+  const tasks = await getTasks();
+  return tasks.find((task) => task.id === id) ?? null;
+}

package/templates/full/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/full/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+};
+
+export default nextConfig;

package/templates/full/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "15.2.4",
+    "react": "19.0.0",
+    "react-dom": "19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.10",
+    "@types/react": "19.0.10",
+    "@types/react-dom": "19.0.4",
+    "typescript": "5.8.2"
+  }
+}

package/templates/full/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}