Open-source meta-system for AI-assisted project management. MCP server + Claude Code skills.
The Library provides 17 tools with consistent naming (verb_noun pattern) and descriptions for all tools and parameters. However, output schemas are not documented in the source code, parameter descriptions lack specificity (format constraints, ranges, enums), and error handling guidance is minimal. Most tools accept string parameters without validation constraints. The checkpoint and memory tools use semicolon/pipe-delimited string encoding rather than structured arrays, forcing LLMs to construct fragile string formats. No tool annotations (readOnlyHint/destructiveHint) are visible despite clear risk levels. Descriptions average ~100 chars (below the 194-char baseline for A+ tools) and lack dependency hints or recovery guidance.
List all checkpoint files. Uses config path if no directory specified.
Read and parse a checkpoint file. Returns structured session state.
Write a session checkpoint. List params are semicolon-separated strings. Structured params use pipe-separated fields within each semicolon-separated entry: open_decisions entries are "question|options|impact"; memory_updates entries are "file|type|content".
Read current library configuration. Pass a section name (e.g. 'vault', 'pm') or empty for all.
Update a configuration value. Example: section='pm', key='provider', value='linear'.
Find merge opportunities for related memories. Analysis only — returns suggestions; no files are modified regardless of dry_run.
Output schemas not documented. No tool returns a documented schema showing field names, types, and structure. LLMs cannot plan downstream calls or extract data reliably.
String-delimited parameters lack format constraints. library_checkpoint_write accepts semicolon/pipe-delimited strings (accomplished, open_decisions, memory_updates) without validation. LLMs must construct fragile string formats prone to parsing errors.
No tool annotations visible. Tools with clear destructive/read-only semantics (library_memory_prune, library_vault_init, library_config_set) lack readOnlyHint/destructiveHint annotations to guide agent safety.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
Remove stale memory files. Set dry_run=False to delete. Updates MEMORY.md index.
Scan memory files for staleness and metadata. Returns entries with stale flags.
Create an epic in the configured PM tool.
Create a task in the configured PM tool (Jira or Linear). Pass epic_id (e.g. 'COS-8') to attach the task as a child of that epic.
Fetch full detail for an issue — fields, comments, available transitions. Returns an IssueDetail serialized as a dict with: id, summary, description, status, labels, parent, assignee, comments (up to 20 most recent), and available_transitions (list of {name, to_status}) that callers can use to decide the next workflow move.
Pull current state from PM tool. Returns open, stale, blocked, recently closed tasks.
Update a task's status or add a comment. If ``status`` is provided but no matching transition exists, this returns a structured error object instead of silently succeeding with stale state: ``{"error": "transition_not_available", "task_id": ..., "current_status": ..., "requested_status": ..., "available_transitions": [...]}`.
Ingest a file or directory into vault sources/<tier>/<category>/. Updates kb.yaml.
Bootstrap a new vault with Karpathy 3-layer structure (_schema/, sources/, wiki/, archive/).
Parse vault wiki articles. Returns tags ([VERIFY]/[CONFLICT]/[PLANNED]), frontmatter, headings.
Validate vault structure against schema. Returns {valid: bool, issues: list}.
Parameter descriptions lack specificity. Most string parameters (section, tier, category, project_key) have generic descriptions without format constraints, valid values, or examples. E.g., 'Configuration section name' does not list valid sections.
Error handling lacks recovery guidance. No tool description explains what to do if a call fails (e.g., 'If vault validation fails, call library_vault_init to bootstrap'). Agents receive no actionable next steps.