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
8 changes: 0 additions & 8 deletions .github/AGENTS.md

This file was deleted.

65 changes: 8 additions & 57 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,59 +1,10 @@
# AGENTS.md
# Rules

A plugin providing development workflow skills for the [jackin](https://github.com/jackin-project/jackin) project.
- No legacy code. Finish every migration: remove old paths completely—no compatibility shims, aliases, or deprecation periods. Breaking changes are preferred.
- This is a research project. It is unsafe and expected to contain breaking changes; never treat it as production-ready. Break things when needed and deliver new implementations fast.
- Always apply these principles:
- Judge work by correctness, consistency, and project fit. Never defer a known-wrong state because of ROI, cost, effort, or claims that it is low-value, marginal, or an edge case.
- Stop only when the required change is proven impossible with the available tools or model. When uncertain, inspect, test, and measure first.
- Before fixing a bug, identify why the architecture permitted it and whether the same structure permits related bugs.
- Prefer fixes that remove the enabling condition. Use a symptom-layer patch only when the root fix is proven infeasible or belongs in a separate change, and name the deferred root cause.

One `skills/<name>/SKILL.md` source serves every supported native plugin and
Amp's native Claude-plugin compatibility bridge.
Installation, the per-client compatibility matrix, and duplicate-avoidance
rules live in `INSTALL.md`. Never install jackin skills into shared global skill
directories; native plugins are the only supported distribution profile.

All skills are **manual-only**. Claude Code, Grok, and Kimi honor
`disable-model-invocation: true`; Codex uses `agents/openai.yaml` with
`policy.allow_implicit_invocation: false`. Every description begins with an
explicit-request guard for clients that ignore those policy fields.

## Skills

Eleven skills live under `skills/`: `jackin-propose`, `jackin-brainstorm`, `jackin-research`, `jackin-create-pr`, `jackin-refresh-pr`, `jackin-checkout-pr`, `jackin-goal-prompt`, `jackin-merge-pr` (feature workflow) and `jackin-release-check`, `jackin-release-notes`, `jackin-release`. All manual-only.

- **What each does, the workflow model, and the design** — see [README.md](README.md).
- **The full process for one skill** — see its `skills/<name>/SKILL.md`.

Invoke by skill name `jackin-<name>` using the native plugin syntax documented
in `INSTALL.md`.

## Requirements

- The target repository must have `cargo-release` configured with `release.toml`
- The target repository must have a `CHANGELOG.md` with `<!-- next-header -->` marker
- The `gh` CLI must be authenticated
- A `.github/workflows/ci.yml` workflow must exist for CI status checks

## Commit Messages

All commits in this repository MUST follow [Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/).

Subject format: `<type>[optional scope][!]: <description>`

Allowed types:

| Type | Use for |
| ---------- | ------------------------------------------------------ |
| `feat` | New user-visible feature |
| `fix` | Bug fix |
| `docs` | Documentation-only change |
| `style` | Formatting, whitespace; no logic change |
| `refactor` | Internal restructuring; no behavior change |
| `perf` | Performance improvement |
| `test` | Adding or updating tests |
| `build` | Build system, tooling, dependencies |
| `ci` | CI configuration |
| `chore` | Routine maintenance (release, merge, deps) |
| `revert` | Reverts a prior commit |

Scope is optional but encouraged when it clarifies the change area.

Breaking changes use `!` after the type/scope (`feat!:` or `feat(api)!:`) and include a `BREAKING CHANGE:` footer in the body.

PR squash-merge: the PR title becomes the commit subject, so PR titles must also follow this convention.
1 change: 1 addition & 0 deletions CLAUDE.md
Loading