Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 78 additions & 0 deletions .claude/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# CLAUDE CODE INTEGRATION

## OVERVIEW

Custom commands and skills for AI-assisted development workflows.

## STRUCTURE

```
.claude/
├── commands/ # Slash commands (6 total)
├── skills/ # Reusable skill packages
│ ├── meta-skill-creator/ # Create new skills
│ └── meta-agent-creator/ # Create new agents
└── settings.local.json # Local settings (gitignored)
```

## COMMANDS

| Command | File | Trigger |
| --------------- | --------------- | --------------------------------------------------- |
| `/branch` | branch.md | Generate branch name: `/branch [type]: desc #issue` |
| `/commit` | commit.md | Analyze changes, create structured commit |
| `/pr` | pr.md | Generate draft PR from commits |
| `/issue-task` | issue-task.md | Create issue with template selection |
| `/plan` | plan.md | Create implementation plan from issue |
| `/make-command` | make-command.md | Scaffold new command file |

## SKILLS

### meta-skill-creator

Create new skills with proper structure.

```bash
bun .claude/skills/meta-skill-creator/scripts/init-skill.ts <name> --path <dir>
bun .claude/skills/meta-skill-creator/scripts/validate-skill.ts <folder>
Comment on lines +36 to +37
Copy link

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The meta-skill-creator examples use "bun" as the command runner (lines 36-37), but the root package.json and pnpm-lock.yaml indicate this project uses pnpm as the package manager. There's no bun configuration or dependency in the project. Either these commands should use a different runner that's actually configured in the project, or bun should be added as a dependency if it's required for these scripts to work.

Copilot uses AI. Check for mistakes.
```

### meta-agent-creator

Create new agents for multi-agent orchestration.

```bash
bun .claude/skills/meta-agent-creator/scripts/init-agent.ts <name> --path <dir> --platform <platform>
bun .claude/skills/meta-agent-creator/scripts/validate-agent.ts <file>
Comment on lines +45 to +46
Copy link

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar to the meta-skill-creator section, the meta-agent-creator examples also use "bun" as the command runner (lines 45-46), but this is inconsistent with the project's use of pnpm. This will cause confusion for users trying to run these commands.

Copilot uses AI. Check for mistakes.
```

## CONVENTIONS

### Command Format

- Markdown files with frontmatter-style instruction blocks
- Use `<command-instruction>` wrapper for main logic
- Include examples for all usage patterns

### Skill Structure

```
skill-name/
├── SKILL.md # Main doc (<500 lines)
├── scripts/ # Automation scripts (TypeScript)
├── references/ # Extended documentation
└── assets/ # Templates, static files
```

### SKILL.md Requirements

- Frontmatter: `name` (kebab-case), `description` (what + when)
- Body: <500 lines, use references/ for overflow
- No README.md, CHANGELOG.md, or redundant files

## ANTI-PATTERNS

- **Long SKILL.md** - Split to references/ if >500 lines
- **Vague descriptions** - Include specific trigger contexts
- **Untested scripts** - Run all scripts before packaging
- **Generic agents** - Each agent needs single, clear purpose
65 changes: 65 additions & 0 deletions .github/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# GITHUB CONFIGURATION

## OVERVIEW

Issue templates, PR template, and CI workflows for automated project management.

## STRUCTURE

```
.github/
├── ISSUE_TEMPLATE/ # 9 issue templates
├── workflows/ # GitHub Actions
│ ├── auto-assign.yml # Auto-assign PRs
│ └── auto-label.yml # Auto-label by title prefix
└── pull_request_template.md
```

## ISSUE TEMPLATES

| Template | Commit Type | Trigger |
| ----------- | ----------- | --------------------------- |
| feat.md | `feat` | New features |
| fix.md | `fix` | Bug fixes (known issue) |
| bug.md | `fix` | Bug reports (user-reported) |
| doc.md | `doc` | Documentation |
| config.md | `config` | Configuration/deps |
| refactor.md | `refactor` | Code improvements |
| agent.md | `agent` | Claude commands/skills |
| test.md | `test` | Test additions |
| perf.md | `perf` | Performance improvements |

## WORKFLOWS

### auto-label.yml

Labels PRs based on title prefix (e.g., `feat:` adds `feat` label).

### auto-assign.yml

Auto-assigns PR creator as assignee.

## CONVENTIONS

### Issue Title Format

```
<type>: <description>
```

Must match one of: feat, fix, doc, config, refactor, agent, test, perf

### PR Title Format

Same as commit message first line:

```
<type>: <brief summary>
```

## ADDING NEW TEMPLATE

1. Create `.github/ISSUE_TEMPLATE/<type>.md`
2. Match existing template structure (Context, Requirement, Solution, Test Plan, Reference)
3. Update auto-label.yml if new type added
4. Update docs/CONVENTIONAL_COMMITS.md mapping table
102 changes: 102 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
# PROJECT KNOWLEDGE BASE

**Generated:** 2026-01-24

## OVERVIEW

GitHub template repository (`@p-stack/oss-kit`) for bootstrapping open-source projects with essential configurations, GitHub workflows, and Claude Code integration.

## STRUCTURE

```
oss-kit/
├── .claude/
│ ├── commands/ # Claude Code slash commands
│ └── skills/ # Claude Code skills
├── .github/
│ ├── ISSUE_TEMPLATE/ # GitHub issue templates (9 types)
│ ├── workflows/ # GitHub Actions (auto-assign, auto-label)
│ └── pull_request_template.md
├── docs/ # Project documentation
│ └── CONVENTIONAL_COMMITS.md
├── AGENTS.md # This file - project knowledge base
├── README.md # Project introduction
├── CONTRIBUTION.md # Contribution guidelines
├── CODE_OF_CONDUCT.md # Contributor code of conduct
└── LICENSE # MIT License
```

## WHERE TO LOOK

| Task | Location | Notes |
| ------------------- | ---------------------------------- | ----------------------- |
| Add issue template | `.github/ISSUE_TEMPLATE/` | Match commit type |
| Modify PR template | `.github/pull_request_template.md` | Single template |
| Add GitHub workflow | `.github/workflows/` | auto-assign, auto-label |
| Add Claude command | `.claude/commands/` | Markdown format |
| Add Claude skill | `.claude/skills/` | Use meta-skill-creator |
| Update docs | `docs/` | Bilingual (en/ko) |
Comment on lines +31 to +38
Copy link

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the table on line 31-38, the "Location" column uses absolute paths starting from the repository root (e.g., ".github/ISSUE_TEMPLATE/"), but the "Task" descriptions use relative language like "Add issue template". For consistency with how users would navigate, consider whether these paths should remain as-is or be described more consistently throughout the document.

Suggested change
| Task | Location | Notes |
| ------------------- | ---------------------------------- | ----------------------- |
| Add issue template | `.github/ISSUE_TEMPLATE/` | Match commit type |
| Modify PR template | `.github/pull_request_template.md` | Single template |
| Add GitHub workflow | `.github/workflows/` | auto-assign, auto-label |
| Add Claude command | `.claude/commands/` | Markdown format |
| Add Claude skill | `.claude/skills/` | Use meta-skill-creator |
| Update docs | `docs/` | Bilingual (en/ko) |
| Task | Repository path (from root) | Notes |
| ------------------- | ---------------------------------- | ----------------------- |
| Add issue template | `./.github/ISSUE_TEMPLATE/` | Match commit type |
| Modify PR template | `./.github/pull_request_template.md` | Single template |
| Add GitHub workflow | `./.github/workflows/` | auto-assign, auto-label |
| Add Claude command | `./.claude/commands/` | Markdown format |
| Add Claude skill | `./.claude/skills/` | Use meta-skill-creator |
| Update docs | `./docs/` | Bilingual (en/ko) |

Copilot uses AI. Check for mistakes.

## CONVENTIONS

### Package Manager & Runtime

- **pnpm@9.0.0** - Use `pnpm` commands, NOT npm/yarn
- **Node.js >=22** - Required runtime version

### Commit Convention (9 types)

| Type | Purpose | Issue Template |
| ---------- | ---------------------- | -------------- |
| `feat` | New features | feat.md |
| `fix` | Bug fixes | fix.md, bug.md |
| `doc` | Documentation | doc.md |
| `config` | Config/deps/CI | config.md |
| `refactor` | Code improvements | refactor.md |
| `agent` | Claude commands/skills | agent.md |
| `format` | Formatting only | (none) |
| `test` | Test changes | test.md |
| `perf` | Performance | perf.md |

### Commit Message Format

```
<type>: <brief summary>

Requirement: (or Goal:)
<why this change is needed>

Implementation:
<what was changed>
```

### Branch Naming

```
i{issue-number}-{type}/{description}
Example: i27-feat/add-agents-md-scope-docs
```

## CLAUDE COMMANDS

| Command | Purpose |
| --------------- | ----------------------------------------- |
| `/branch` | Generate branch name from issue |
| `/commit` | Analyze changes, create structured commit |
| `/pr` | Generate draft PR with analysis |
| `/issue-task` | Create GitHub issue with template |
| `/plan` | Create implementation plan from issue |
| `/make-command` | Scaffold new Claude command |

## ANTI-PATTERNS (THIS PROJECT)

- **No `chore` type** - Use `config` instead (work is never unimportant)
- **No npm/yarn** - pnpm only
- **No README.md in skills** - Only SKILL.md per meta-skill-creator spec
- **No generic "helper" agents** - Single responsibility per agent

## NOTES

- **Template repo**: This is a GitHub template - use "Use this template" button
- **Under development**: External contributions not yet accepted
- **Bilingual docs**: README.md + README.ko.md pattern
36 changes: 0 additions & 36 deletions apps/docs/.gitignore

This file was deleted.

36 changes: 0 additions & 36 deletions apps/docs/README.md

This file was deleted.

Binary file removed apps/docs/app/favicon.ico
Binary file not shown.
Binary file removed apps/docs/app/fonts/GeistMonoVF.woff
Binary file not shown.
Binary file removed apps/docs/app/fonts/GeistVF.woff
Binary file not shown.
50 changes: 0 additions & 50 deletions apps/docs/app/globals.css

This file was deleted.

Loading