-
Notifications
You must be signed in to change notification settings - Fork 0
refactor: remove Turborepo monorepo structure, convert to pure OSS template #29
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| 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> | ||
| ``` | ||
|
|
||
| ### 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
|
||
| ``` | ||
|
|
||
| ## 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 | ||
| 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 |
| 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
|
||||||||||||||||||||||||||||||||||
| | 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) | |
This file was deleted.
This file was deleted.
This file was deleted.
There was a problem hiding this comment.
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.