record-project-fact

Records confirmed project facts into an existing AGENTS.md with approval-gated edits.

3|Updated May 20, 2026
One-click install
npx skills add https://github.com/jongcheol-pak/claude-harness-pjc --skill record-project-fact-jongcheol-pak
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: record-project-fact
Source: https://github.com/jongcheol-pak/claude-harness-pjc/tree/main/plugins/pjc/skills/record-project-fact
Command: npx skills add https://github.com/jongcheol-pak/claude-harness-pjc --skill record-project-fact-jongcheol-pak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Project facts like build commands, test commands, and DB access methods get rediscovered every session or go stale, and an overgrown AGENTS.md can exceed its session injection limit. This Skill records verified facts into an existing AGENTS.md, keeps entries current, and relocates oversized sections when the injection budget is approached. ## Core Features & Use Cases - Approval-gated recording: Add, update, or remove entries in mapped sections (Build & Test, 데이터 접근, 산출물·파일 관리, Conventions) only after showing the exact change and getting approval; secrets are stored as environment variable names only. - Injection-limit relocation: Runs scripts/relocate-agents.py to move oversized sections verbatim into a deterministic destination doc, leave a pointer line, keep timestamped backups, and roll back automatically if verification fails. - Retrofit handoff: For "clean up AGENTS.md" requests, measures section sizes, judges each section's destination, and hands the approved plan to pjc:plan instead of editing directly. - Use Case: After confirming dotnet test tests/ works, ask to record the test command; the Skill shows the exact line and section, waits for approval, edits AGENTS.md, then checks whether the file is nearing its injection limit. ## Quick Start Ask the assistant to record the confirmed build and test commands into AGENTS.md and approve the proposed change when shown.

Frequently Asked Questions about record-project-fact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record a build or test command into AGENTS.md?▼

Ask to record the confirmed command, and the Skill maps it to the Build & Test section, shows the exact add or update line, and edits AGENTS.md only after you approve. Only facts you have actually executed and verified are recorded.

What happens when AGENTS.md exceeds its injection size limit?▼

The Skill runs scripts/relocate-agents.py, which moves the largest non-essential sections verbatim into a destination markdown file, leaves a pointer line in place, and keeps timestamped backups. If verification fails, it rolls back automatically and reports the result.

Can this Skill create a new AGENTS.md file?▼

No. It only updates an existing AGENTS.md. If the file is missing, it directs you to pjc:plan Step 1, which creates the minimal AGENTS.md with build and test commands plus an architecture declaration line.

Does it store database passwords or API keys in AGENTS.md?▼

No. Real secrets such as connection strings, passwords, tokens, and internal hosts are forbidden. Only environment variable names or configuration key names are recorded, with actual values kept in a gitignored .env file.

Why does the relocation script exit with code 2?▼

Exit code 2 means an input error, such as a missing AGENTS.md or insufficient arguments, not a passed check. Exit code 0 means relocation succeeded or was not triggered, and 1 means verification failed and changes were rolled back.

When should I use the retrofit cleanup instead of normal recording?▼

Use retrofit when you ask to reorganize an existing AGENTS.md to new content boundaries. It measures section sizes, judges each section's destination, and hands the approved plan to pjc:plan rather than editing directly, because deletions require approval.