ag-dir

分类: 工具与效率 | 上传者: kevinslin | 下载: 0 | 版本: v1.0（最新）

Define and maintain an Agent Project Directory (AGD) with clear durable

更新日志: Source: GitHub https://github.com/kevinslin/skills

目录结构

当前层级: active/ag-dir/

📄 SKILL.md 1.8 KB

SKILL.md

---
name: ag-dir
description: Define and maintain an Agent Project Directory (AGD) with clear durable
  docs, canonical status ownership, and isolated runtime artifacts.
dependencies:
- ag-ledger
- dev.research
---

# AG Directory (AGD)

Use this skill when creating, auditing, or updating a durable AG directory (AGD) for one task.

## Core Concept

```text
├── AGENTS.md
├── design.md
├── memory.md
├── config.md
├── progress.md
├── specs
│   ├── spec-01-<name>.md
│   └── spec-02-<name>.md
└── .agents
    ├── runs/
        └── spec-{num}-progress.md
        └── spec-{num}-learnings.md
```

Durable project docs stay at the root. Runtime and local-only artifacts stay under `.agents/`.

## File Contracts

- `memory.md`: Relevant memory for this project only. Keep stable facts, decisions, and known constraints.
- `config.md`: Non-secret config schema/defaults and env var names. Do not store secret values.
- `design.md`: The project-level design document (from `$dev.research` design-doc workflows).
- `progress.md`: Single global status board with milestones, blockers, and next actions.
- `specs/*.md`: Feature specs (from `$dev.research` feature-spec workflows) 

## Operating Rules

1. Keep project-level status in `progress.md`
2. create `spec-*-progress.md` or `spec-*-learnings.md` under `.agents/runs/`
3. Keep `memory.md` concise and durable; remove stale hypotheses once resolved.
4. Keep spec numbering stable (`spec-01`, `spec-02`, ...). Avoid renaming active specs.
5. Keep top-level files limited to durable docs; isolate runtime churn under `.agents/`.

## Recommended Workflow

1. Create the AGD skeleton.
2. Draft `design.md`.
3. Add one or more feature specs in `specs/`.
4. Roll key outcomes and cross-spec updates into `progress.md`.
5. Add spec specific progress under `.agents/runs`

登录后下载/点赞/收藏 ❤ 8 | ★ 0

ag-dir

目录结构

SKILL.md

举报内容

提示