xia

/xia — Borrow and Adapt from GitHub Projects

Xỉa (Vietnamese): borrow/take something from others and use it in your own product.

This is a protocol, not a workflow description. Follow each phase exactly. Output templates are mandatory — fill them in, do not paraphrase or reformat them.

---

CONSTRAINTS — Read before writing any code

Step 1: Read the project coding rules.

Read(file_path: "~/.claude/CLAUDE.md")

Extract and list every coding constraint found. These apply to ALL code written in this session.

Step 2: Confirm constraints before proceeding.

Output this block exactly:

## Constraints active for this session
- [list each rule from CLAUDE.md, one per line]

Do not skip this. Do not proceed to Phase 0 until this block is printed.

---

Usage

/xia <github-repo> [focus]

• <github-repo>: GitHub URL or user/repo shorthand
• [focus]: Optional — specific aspect to focus on

Storage

Xỉa state is project-local, stored inside the repo and committed to git:

<project-root>/
└── .claude/
    └── xia/
        ├── XIALOGUE.md
        └── patterns/
            └── xia-[repo-slug]-[pattern].md

Install Targets

Default: always project-local first.

What is borrowed	Install to	Promote to ~/.claude/ when
Pattern / workflow	.claude/xia/patterns/	Never — stays project-local
Skill	.claude/skills/	After 5+ sessions of proven value, on explicit user request
Agent	.claude/agents/	After 5+ sessions of proven value, on explicit user request
Command	.claude/commands/	After 5+ sessions of proven value, on explicit user request

Never install directly to ~/.claude/ unless the user explicitly says "install globally".

---

Phase 0 — Know A

Input: current working directory

Step 1 — Check prior Xỉa state:

cat .claude/xia/XIALOGUE.md 2>/dev/null || echo "XIALOGUE_MISSING"