# Project Notes

> Persistent project knowledge base — decisions, context, conventions

- **Type:** Skill
- **Install:** `agentstack add skill-anthroos-claude-code-orchestrator-project-notes`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [anthroos](https://agentstack.voostack.com/s/anthroos)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [anthroos](https://github.com/anthroos)
- **Source:** https://github.com/anthroos/claude-code-orchestrator/tree/main/skills/examples/project-notes

## Install

```sh
agentstack add skill-anthroos-claude-code-orchestrator-project-notes
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Project Notes

> Maintain a persistent knowledge base about the project. Claude reads this at the start of relevant tasks to have context without you re-explaining.

## When to use

- "Remember that we use Postgres, not MySQL"
- "What do we know about the auth system?"
- "Add this to project notes"
- "What conventions do we follow?"
- When starting work on a project area you haven't touched in a while

## Paths

| What | Path |
|------|------|
| Notes directory | `$PROJECT_ROOT/notes/` |
| Architecture notes | `$PROJECT_ROOT/notes/architecture.md` |
| Conventions | `$PROJECT_ROOT/notes/conventions.md` |
| Decisions log | `$PROJECT_ROOT/notes/decisions.md` |

## How to execute

### Reading notes

```bash
# List all notes
ls $PROJECT_ROOT/notes/

# Read specific topic
cat $PROJECT_ROOT/notes/architecture.md
```

### Adding a note

Append to the appropriate file, or create a new topic file:

```markdown
## [Topic] (YYYY-MM-DD)

**Decision:** [What was decided]
**Context:** [Why this decision was made]
**Alternatives considered:** [What else was considered]
```

### Note categories

| File | What goes here |
|------|---------------|
| `architecture.md` | System design, service boundaries, data flow |
| `conventions.md` | Naming, file structure, coding standards |
| `decisions.md` | ADRs — why we chose X over Y |
| `integrations.md` | External services, API keys location, endpoints |
| `troubleshooting.md` | Known issues and their fixes |

## Examples

### Adding a decision

```markdown
## Use Redis for caching (2024-03-15)

**Decision:** Use Redis instead of in-memory caching
**Context:** App runs on multiple instances, need shared cache
**Alternatives:** Memcached (less features), in-memory (no sharing)
```

### Adding a convention

```markdown
## API Response Format

All API endpoints return:
\```json
{
  "data": {...},
  "error": null,
  "meta": {"timestamp": "...", "request_id": "..."}
}
\```
```

## Tips

- Keep notes **concise** — bullet points over paragraphs
- Include **dates** — context changes over time
- Link to **code** — `src/auth/middleware.ts:45` is better than "the auth middleware"
- **Delete outdated notes** — stale context is worse than no context

## Related skills

- `daily-summary` — uses project notes for context

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [anthroos](https://github.com/anthroos)
- **Source:** [anthroos/claude-code-orchestrator](https://github.com/anthroos/claude-code-orchestrator)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-anthroos-claude-code-orchestrator-project-notes
- Seller: https://agentstack.voostack.com/s/anthroos
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.