New Project Setup

Skill: new-project-setup

When to use

Project chưa có llmwiki/. Hoặc reset từ đầu.

Steps

1. CHECK llmwiki tồn tại:

test -d llmwiki && echo exists || echo missing

exists → hỏi user reset không. Reset = xóa concepts/ + entities/, GIỮ log.md + sources/.

2. Pull template + install skills:

# INVOKE: sync-template
# sync-template tự pull từ rheinmir/setup@orca và install skills vào:
#   .claude/commands/           → Claude Code
#   ~/.agents/skills/*/SKILL.md → OpenCode / Antigravity

3. Init wiki folder structure:

mkdir -p llmwiki/wiki/{concepts,entities,sources/draft} llmwiki/{skills,raw}
touch llmwiki/wiki/index.md llmwiki/wiki/log.md llmwiki/raw/.gitkeep

4. RTK token proxy (WSL only):

# Guard — chỉ chạy trong WSL:
uname -r | grep -qi microsoft || { echo "RTK install: WSL only — skip"; exit 0; }

# CHECK đã cài chưa:
rtk --version 2>/dev/null || {
  curl -fsSL https://github.com/rtk-ai/rtk/releases/latest/download/rtk-x86_64-unknown-linux-musl.tar.gz \
    | tar xz -C /usr/local/bin
}

# Init global config + patch ~/.claude/settings.json:
rtk init -g

# Verify hook:
grep -q "rtk hook claude" ~/.claude/settings.json && echo "RTK hooked" || echo "MANUAL: add rtk hook to settings.json"

5. Seed wiki:

# Đọc README.md, package.json hoặc go.mod → project name + stack

• Tạo llmwiki/wiki/sources/project-requirements.md — frontmatter + ## Origin
• OKF v0.1 (R9): frontmatter là khối YAML --- có type không rỗng — copy _template.md, đừng dùng **Type:** bold (format cũ).
• Append llmwiki/wiki/log.md: ## YYYY-MM-DD — init — <project-name>
• Tạo llmwiki/wiki/index.md — header + empty table

6. INVOKE: onboard-codebase → populate concepts/ + entities/ + lint.

Rules

• Skill install: sync-template step 7 xử lý — không duplicate
• onboard-codebase includes lint — không gọi lint thêm
• RTK guard uname -r | grep -qi microsoft bắt buộc trước curl

Output Report

After all main skill tasks complete, write a propose draft to the wiki.

Steps

1. Build the filename:

• Format: DDMMYY-<ten>.md
• DDMMYY = today (e.g., 020626 for 2 June 2026)
• <ten> = 2–4 kebab-case words summarising what was done (e.g., landing-page-coteccons, brand-kit-fintech, ingest-auth-spec)

2. Write llmwiki/wiki/sources/draft/DDMMYY-<ten>.md:

# DDMMYY-<ten>
**Type:** draft
**Status:** proposed
**Tags:** <skill-name>, output-report
**Proposed:** YYYY-MM-DD

## What
<One sentence — what this skill invocation produced or decided>

## Output
<Key artefacts, files created/modified, or decisions made>

## Files
| File | Action |
|------|--------|
| `path/to/file` | created / modified |

## Notes
- Invoked via: `/<skill-name>` skill

## Origin
- **Draft:** `wiki/sources/draft/DDMMYY-<ten>.md`
- **Commit:** _(filled by verify-before-commit)_
- **Date promoted:** _(filled by verify-before-commit)_

3. Update wiki index & log:

• llmwiki/wiki/index.md — append one row: | [DDMMYY-<ten>](sources/draft/DDMMYY-<ten>.md) | draft | YYYY-MM-DD |
• llmwiki/wiki/log.md — append: ## YYYY-MM-DD — <skill-name> — <ten>

Skip only when the skill produces zero artefacts and zero decisions (e.g., a pure display mode like /caveman-stats).