What is own-planner CLAUDE.md?

A set of instructions for OwnPlanner, a personal planning assistant with a .NET backend, a React and TypeScript web interface, and per-user SQLite databases. It explains the project layout and commands for checking each part or the whole application.

Use it when changing or testing the backend, frontend, database features, or chat tools in OwnPlanner.

It tells an AI assistant which instruction file is authoritative and how to verify changes. This reduces unnecessary testing and helps avoid mixing frontend and backend responsibilities.

How am-space/own-planner configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to am-space/own-planner. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/am-space/own-planner/master/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/am-space/own-planner

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/am-space/own-planner/claude-md/github.svg)](https://agentmods.dev/instructions/am-space/own-planner/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/am-space/own-planner/claude-md"><img src="https://agentmods.dev/badge/instructions/am-space/own-planner/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/am-space/own-planner/claude-md"><img src="https://agentmods.dev/badge/instructions/am-space/own-planner/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,732 This file is loaded in full into every session.

When invoked 1,732 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.01732	$0.01732
Opus 5.5	$0.00693	$0.00693
Sonnet 5.5	$0.00346	$0.00346
Haiku 4.5	$0.00173	$0.00173

Measured 1mo ago against content hash 87b2435387c4, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

own-planner CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 129 lines

How it starts

The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

AGENTS.md is the canonical source for shared repository guidance. Read it and the closest nested AGENTS.md for the component being changed; if duplicated guidance differs, follow AGENTS.md.

Overview

OwnPlanner is an AI-powered personal planning assistant: a layered .NET 10 solution with a React + TypeScript (Vite, MUI) frontend. Users chat with a Google Gemini LLM that invokes in-process MCP-style tools to manage tasks, notes, goals, and contexts stored in per-user SQLite databases.

Common commands

Run from the repo root unless noted.

# Install/restore dependencies, then run the full local CI-equivalent verification
./scripts/setup.sh
./scripts/verify.sh

# Verify only one stack
./scripts/verify.sh --backend
./scripts/verify.sh --frontend

# Single test project, class, or method
dotnet test --project OwnPlanner.Application.Tests/OwnPlanner.Application.Tests.csproj
dotnet test --project OwnPlanner.Domain.Tests --filter-class "OwnPlanner.Domain.Tests.Tasks.TaskItemTests"
dotnet test --project OwnPlanner.Domain.Tests --filter-method "*Ctor_Valid_SetsProperties"

# Run the web server (auto-launches the Vite dev server via SpaProxy)
dotnet run --project OwnPlanner.Web/OwnPlanner.Web.Server   # http://localhost:5079

# Run the console chat loop (type `exit` to quit)
dotnet run --project OwnPlanner.Console

Frontend (from OwnPlanner.Web/ownplanner.web.client/):

npm ci
npm run dev      # Vite dev server
npm run build    # tsc -b && vite build
npm run lint     # eslint

CI (.github/workflows/ci.yml) uses the same scripts: scripts/setup.sh, then frontend and backend verification. Run ./scripts/verify.sh before pushing to match both verification paths locally.

Git workflow

Never commit directly to master.
Before the first task commit, create or switch to a dedicated branch. Unless the user specifies another name, use feature/<short-description> for enhancements and fix/<short-description> for bug fixes.
Keep unrelated staged or working-tree changes out of task commits.
Open a pull request targeting master when the work is ready for review.

Read the full file on GitHub · 129 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago Changed · +25 tokens per session 87b2435387c4
2mo ago First seen · 129 lines · 1,707 tokens per session scan A 1022102ecdf5

Subscribe to this mod's changes

own-planner CLAUDE.md is an instructions file published in the GitHub repository am-space/own-planner (2 stars, last pushed 1mo ago), licensed MIT. It adds 1,732 tokens to every session, about $0.0069 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

C# and .NET LLM Planning architecture dotnet mcp-client mcp-server

own-planner CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
own-planner CLAUDE.mdam-space/own-planner	Instructions file	2	1mo ago	MIT	A	1,732	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

own-planner: Instructions file for Claude Code