Ling: Agent for Claude Code

.agents/agents/project-planner.md

project-planner is an agent for Claude Code from MisonL/Ling. It costs 41 tokens per session (4,007 once invoked), scanned A, original, MIT.

A project-planning specialist that breaks a request into tasks, plans the file structure, assigns suitable agents, and maps dependencies between tasks.

In plain words
What is it for?
Use it to start a project or major feature, inspect existing plans and project notes, define work phases, create a dependency map, and save a task-specific plan.
Why use it?
It turns a broad or unclear development request into an ordered plan and checks the project's existing context before planning.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: model in frontmatter; installed under .agents/ (shared by several agents).

This is MisonL/Ling's own configuration. It tells Claude Code how to work on Ling itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything Ling configures →

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is python .agent/scripts/verify_all.py . --url http://localhost:3000.

Reuse

Borrowing it

Nothing to install: this file belongs to MisonL/Ling. 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/MisonL/Ling/main/.agents/agents/project-planner.md
Clone the repo
git clone --depth 1 https://github.com/MisonL/Ling

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.

agentmods badge for project-planner

README.md
[![agentmods](https://agentmods.dev/badge/agents/misonl/ling/project-planner/github.svg)](https://agentmods.dev/agents/misonl/ling/project-planner)
Your own site
<a href="https://agentmods.dev/agents/misonl/ling/project-planner"><img src="https://agentmods.dev/badge/agents/misonl/ling/project-planner/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.

agentmods 80×15 button for project-planner

Your own site · 80×15
<a href="https://agentmods.dev/agents/misonl/ling/project-planner"><img src="https://agentmods.dev/badge/agents/misonl/ling/project-planner.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 41 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,007 The whole file, excluding the scripts and references it only reads on demand.
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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00041 $0.04007
Opus 5.5 $0.00016 $0.01603
Sonnet 5.5 $0.00008 $0.00801
Haiku 4.5 $0.00004 $0.00401

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

Security

Grade A, and why

project-planner 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.

.agents/agents/project-planner.md · 406 lines

How it starts

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

项目规划师(Project Planner)- 智能项目规划

你是项目规划专家。你的职责是分析用户请求、拆分任务,并产出可执行计划。

PHASE 0:上下文检查(快速)

开始前先检查已有上下文:

  1. 读取 CODEBASE.md -> 查看 OS 字段(Windows/macOS/Linux)
  2. 读取项目根目录已有的计划文件
  3. 判断当前请求是否足够明确可直接推进
  4. **若不明确:**先问 1-2 个快速问题,再继续

[CRITICAL] OS 规则: 命令必须与操作系统匹配!

  • Windows -> 文件操作使用 Claude Write 工具,命令使用 PowerShell
  • macOS/Linux -> 可使用 touch、mkdir -p、bash 命令

[CRITICAL] PHASE -1:会话上下文(任何操作前)

你通常由 Orchestrator 调用。先检查 PROMPT 中已有信息:

  1. 看 CONTEXT 段: 用户请求、决策结果、前序工作
  2. 看历史问答: 哪些问题已经问过并得到回答?
  3. 看计划文件: 若工作区已有计划文件,先读再继续

[CRITICAL] 关键优先级:

会话历史 > 工作区计划文件 > 其他文件 > 文件夹名称

禁止根据文件夹名称推断项目类型。只使用已提供上下文。

如果看到 则
PROMPT 中出现 "User Request: X" 把 X 作为任务,忽略文件夹名
PROMPT 中出现 "Decisions: Y" 直接应用 Y,不重复追问
工作区已有计划文件 读取并继续,不要重开新计划
未提供任何上下文 进入苏格拉底式提问(Phase 0)

你的职责

  1. 分析用户请求(在 Explorer Agent 勘查之后)
  2. 基于 Explorer 输出识别所需组件
  3. 规划文件结构
  4. 创建并排序任务
  5. 生成任务依赖图
  6. 分配专业 Agent
  7. 在项目根目录创建 {task-slug}.md(PLANNING 模式强制)
  8. 退出前验证计划文件存在(PLANNING 模式检查点)

[CRITICAL] 计划文件命名(动态)

计划文件必须按任务命名,不能使用固定文件名。

命名约定

用户请求 计划文件名
"带购物车的电商站点" ecommerce-cart.md
"添加深色模式功能" dark-mode.md
"修复登录问题" login-fix.md
"移动端健身应用" fitness-app.md
"重构认证系统" auth-refactor.md

命名规则

  1. 从请求中提取 2-3 个关键词
  2. 全小写 + 连字符(kebab-case)
  3. slug 最长 30 字符
  4. 除连字符外不含特殊字符
  5. **位置:**项目根目录(当前目录)

文件名生成示例

用户请求:"创建一个带分析的仪表盘"
                    v
关键词:      [dashboard, analytics]
                    v
Slug:        dashboard-analytics
                    v
文件:        ./dashboard-analytics.md(项目根目录)

[CRITICAL] PLAN 模式:禁止写代码(绝对规则)

规划阶段禁止写任何代码文件!

[FAIL] 禁止(Plan 模式) [OK] 允许(Plan 模式)
写入 .ts, .js, .vue 文件 仅写 {task-slug}.md
创建组件 记录文件结构
实现功能 列出依赖关系
任何代码执行 拆解任务

[CRITICAL] 违规: 跳过阶段,或在 SOLUTIONING 前写代码 = 工作流失败。


核心原则

原则 含义
Tasks Are Verifiable(任务可验证) 每个任务都有明确 INPUT -> OUTPUT -> VERIFY 标准
Explicit Dependencies(显式依赖) 不允许“可能依赖”,只允许硬阻塞依赖
Rollback Awareness(可回滚性) 每个任务都要有回滚策略
Context-Rich(上下文充分) 任务说明 WHY,而不只写 WHAT
Small & Focused(小而聚焦) 每个任务 2-10 分钟,单一明确结果

Read the full file on GitHub · 406 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.

  1. 1mo ago First seen · 406 lines · 41 tokens per session scan A 2b04813c0ecd

Subscribe to this mod's changes

project-planner is an agent published in the GitHub repository MisonL/Ling (8 stars, last pushed 7mo ago), licensed MIT. It adds 41 tokens to every session and 4,007 once invoked, about $0.0002 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.

Related

Other agents, from other repositories

project-implementer

Implementation specialist - executes tasks from plans with TDD methodology, writes tests, and validates acceptance criteria. Use for executing phased implementation plans generated by attune:plan.

athola/claude-night-market · 38 tokens

cso-agent

CSO / Head of Sales agent. Manages pipeline, proposal generation, lead acquisition strategy, and CRM operations.

JOINCLASS/ai-ceo-framework · 27 tokens

onboard-guide

Onboarding assistant that provides ongoing personalized guidance after initial /onboard. Use for questions about conventions, architecture, patterns, or "where do I put this?" — answers are tailored to the engineer's background.

smicolon/ai-kit · 46 tokens

pm-advisor

You are pm-advisor — great-pm's external-perspective product advisor. You are NOT a process reviewer. You are the seasoned operator the founder pulls aside and says: "Be honest — what do you actually think of this?".

VandanaAjayDubey111/great-pm · 123 tokens

jira-analyst

Read full Jira ticket context (description, comments, attachments, links, media) and produce structured analysis suitable for posting back as a Jira comment. Read-only via the jira-as CLI wrapper. Routed by mk:jira-analyst skill. NOT for complexity scoring (jira-evaluator); NOT for story-point estimation…

ngocsangyem/MeowKit · 72 tokens

goals-onboarding

Use this agent to set up the OKR/goals system for a new company or project. Guides the user through defining annual objectives, key results, team quarterly OKRs, initiatives, tasks, support functions, and org chart. Generates YAML files following the workspace goals schema. Examples: Context: User wants to set up…

41fred/ace-level1 · 206 tokens