Bỏ qua tới nội dung
TakoAPI
Quay lại kỹ năng

cursorkleosr

bởi kleosr

Cursor
—Chưa có đánh giá
Đánh giá của bạn

Tóm tắt

Make AI Development Feel Natural in Cursor

Mô tả

<div align="center">
  <img src="https://img.shields.io/badge/schema-1.2-blue?style=flat-square" />
  <img src="https://img.shields.io/badge/license-MIT-brightgreen?style=flat-square" />
  <img src="https://img.shields.io/badge/status-stable-2ea44f?style=flat-square" />
  <img src="https://img.shields.io/badge/built%20for-Cursor%20rules-111827?style=flat-square" />
</div>

<br />

<div align="center">
  <h1>cursorkleosr</h1>
  <p><strong>Agent memory that cannot be forgotten — one always-on Cursor rule plus root markdown state.</strong></p>
  <p>Skills wait to be invoked. Rules load every session.<br />The agent reads your project state before it thinks — no more starting from zero.</p>
</div>

<br />

---

## The Breakthrough

Most agent-memory setups are opt-in: a skill the agent must remember to call, a file the human must paste into chat. This one is **always-on**.

`.cursor/rules/workflow-memory.mdc` ships with `alwaysApply: true`, so Cursor injects the operating loop into every agent session automatically. The agent's first move is reading `workflow_state.md` — before you ask for anything. When it finishes meaningful work, it writes state back. Memory stops being a feature you invoke and becomes a property of the repository.

## Setup

```bash
git clone https://github.com/kleosr/cursorkleosr.git
cd cursorkleosr
```

Open `project_config.md`, set your goals and stack. Open `workflow_state.md`, set `Phase: INIT — READY`. Done — no dependencies, no build step.

## Usage

There is nothing to invoke. Open the repo in Cursor and work:

- **Session start** — the agent reads `workflow_state.md` and `project_config.md`, then reconstructs the next action on its own.
- **During work** — one phase at a time: `ANALYZE → PREPARE → IMPLEMENT → VALIDATE`.
- **After meaningful change** — the agent writes state back. No per-message noise.

Manual fallback, from any terminal:

```bash
cat workflow_state.md   # where are we?
cat project_config.md   # what are we building?
```

## Files

| File | Purpose |
|------|---------|
| `AGENTS.md` | Single source of truth agent handbook: Rules, Skills, Workflows, Memory |
| `.cursor/rules/workflow-memory.mdc` | Thin adapter importing `@AGENTS.md` for Cursor |
| `workflow_state.md` | Moving parts: current phase, plan, blockers, log |
| `project_config.md` | Slow-changing facts: goals, stack, patterns, constraints, changelog |
| `Instructions.md` | Human-facing reminder of the read → act → write loop |

## Workflow Loop

```
read state → read config → act → write state back
                     ↓
            ANALYZE → PREPARE → IMPLEMENT → VALIDATE
```

```mermaid
graph LR
    S[Session Start] --> A[Read workflow_state.md];
    A --> B{Task Ready?};
    B -- Yes --> C[Process Next Task];
    B -- No --> D[Continue Current Work];
    D --> E[Execute Step];
    E --> F[Update workflow_state.md];
    F --> G{Validation Needed?};
    G -- Yes --> H[Run Checks];
    G -- No --> D;
    C --> I{More Tasks?};
    I -- Yes --> J[Reset Workspace];
    J --> K[Fresh Start];
    K --> A;
    I -- No --> L[Mark Complete];
    L --> M[Idle];
```

## Architecture

```
.
├── .cursor/
│   └── rules/
│       └── workflow-memory.mdc  — thin adapter importing @AGENTS.md
├── AGENTS.md                    — canonical agent handbook (Rules, Skills, Workflows, Memory)
├── project_config.md            — goals, stack, patterns, constraints, changelog
├── workflow_state.md            — phase, plan, blockers, log
├── Instructions.md              — human loop reminder
└── LICENSE                      — MIT
```

Zero dependencies. No build step. Root markdown stays editable in any editor, diffable in any tool, and greppable from any terminal.

## Development

Documentation-only project. No tests, no compilation, no CI pipeline. Validate edits with:

```bash
git diff --check
```

## Why Markdown?

Plain text outlasts everything. No database, no schema migrations, no lock-in, no dependency chain. State you can read, diff, and grep from anywhere — and a rule the agent cannot ignore.

## License

MIT. See [LICENSE](LICENSE).

Cài đặt

Cài kỹ năng từ https://github.com/kleosr/cursorkleosr

Kỹ năng này chưa được đăng trên registry ClawHub. Hãy dán prompt vào coding agent của bạn — Claude Code, Cursor, Codex — và nó sẽ cài kỹ năng thẳng từ kho mã nguồn.

Mở kho mã

Liên kết