Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-documentation

hyper-documentation

Flagged

[Hyper] Use this skill when the user asks to create, refactor, or update a documentation artifact: a project or package README.md, a repository AGENTS.md with its AGENTS.ko.md mirror, an AI-readable instruction base, runbook, specification, or rule pack, a reusable prompt, prompt template, prompt pack, or prompt eval fixture, or an agent's persistent memory files (MEMORY.md index, memory bank, lessons file) with their write, pruning, and deletion rules. It picks one mode from the requested output and grounds every claim in the project and its sources. Do not use for reusable skill folders, CHANGELOG, CONTRIBUTING, LICENSE, release notes, answer-only research, or implementation work; it never writes CLAUDE.md.

FileKindSize
SKILL.ko.mdmarkdown21.2 KB
SKILL.mdskill md19.3 KB
assets/evals/hyper-documentation-cases.jsonlother90.3 KB
assets/prompt/eval-harness.template.jsonconfig3.0 KB
assets/prompt/prompt-pack.template.ko.mdmarkdown2.1 KB
assets/prompt/prompt-pack.template.mdmarkdown1.9 KB
assets/prompt/source-ledger.template.ko.mdmarkdown2.1 KB
assets/prompt/source-ledger.template.mdmarkdown2.0 KB
references/memory/evidence-ledger.ko.mdmarkdown55.2 KB
references/memory/evidence-ledger.mdmarkdown51.1 KB
references/official/anthropic.ko.mdmarkdown12.7 KB
references/official/anthropic.mdmarkdown11.9 KB
references/official/openai.ko.mdmarkdown13.5 KB
references/official/openai.mdmarkdown12.8 KB
references/prompt/eval-harness-guide.ko.mdmarkdown5.8 KB
references/prompt/eval-harness-guide.mdmarkdown5.3 KB
references/prompt/prompt-pack-schema.ko.mdmarkdown3.9 KB
references/prompt/prompt-pack-schema.mdmarkdown3.6 KB
references/readme/readme-templates.ko.mdmarkdown4.4 KB
references/readme/readme-templates.mdmarkdown4.1 KB
rules/agents-md/instruction-design.ko.mdmarkdown13.8 KB
rules/agents-md/instruction-design.mdmarkdown12.6 KB
rules/agents-md/mode-contract.ko.mdmarkdown18.4 KB
rules/agents-md/mode-contract.mdmarkdown17.0 KB
rules/agents-md/nested-placement.ko.mdmarkdown3.5 KB
rules/agents-md/nested-placement.mdmarkdown3.2 KB
rules/agents-md/project-discovery.ko.mdmarkdown8.2 KB
rules/agents-md/project-discovery.mdmarkdown7.7 KB
rules/agents-md/rule-file-splitting.ko.mdmarkdown5.9 KB
rules/agents-md/rule-file-splitting.mdmarkdown5.2 KB
rules/agents-md/validation.ko.mdmarkdown10.2 KB
rules/agents-md/validation.mdmarkdown9.4 KB
rules/docs/context-engineering.ko.mdmarkdown13.1 KB
rules/docs/context-engineering.mdmarkdown12.0 KB
rules/docs/forbidden-patterns.ko.mdmarkdown6.0 KB
rules/docs/forbidden-patterns.mdmarkdown5.8 KB
rules/docs/harness-engineering.ko.mdmarkdown15.1 KB
rules/docs/harness-engineering.mdmarkdown13.7 KB
rules/docs/layer-model.ko.mdmarkdown1.3 KB
rules/docs/layer-model.mdmarkdown1.3 KB
rules/docs/mode-contract.ko.mdmarkdown13.1 KB
rules/docs/mode-contract.mdmarkdown12.7 KB
rules/docs/required-behaviors.ko.mdmarkdown9.4 KB
rules/docs/required-behaviors.mdmarkdown8.7 KB
rules/docs/sourcing.ko.mdmarkdown5.7 KB
rules/docs/sourcing.mdmarkdown5.3 KB
rules/docs/structured-reasoning.ko.mdmarkdown2.9 KB
rules/docs/structured-reasoning.mdmarkdown2.8 KB
rules/docs/validation.ko.mdmarkdown10.0 KB
rules/docs/validation.mdmarkdown9.3 KB
rules/memory/lifecycle.ko.mdmarkdown5.6 KB
rules/memory/lifecycle.mdmarkdown4.8 KB
rules/memory/mode-contract.ko.mdmarkdown8.3 KB
rules/memory/mode-contract.mdmarkdown6.9 KB
rules/memory/safety.ko.mdmarkdown5.9 KB
rules/memory/safety.mdmarkdown5.3 KB
rules/memory/structure.ko.mdmarkdown6.1 KB
rules/memory/structure.mdmarkdown5.3 KB
rules/memory/validation.ko.mdmarkdown3.8 KB
rules/memory/validation.mdmarkdown3.4 KB
rules/mode-routing.ko.mdmarkdown6.1 KB
rules/mode-routing.mdmarkdown5.7 KB
rules/prompt/anti-patterns.ko.mdmarkdown2.4 KB
rules/prompt/anti-patterns.mdmarkdown2.3 KB
rules/prompt/artifact-levels.ko.mdmarkdown1.1 KB
rules/prompt/artifact-levels.mdmarkdown1.1 KB
rules/prompt/context-source-safety.ko.mdmarkdown5.2 KB
rules/prompt/context-source-safety.mdmarkdown4.6 KB
rules/prompt/evaluation-and-iteration.ko.mdmarkdown6.9 KB
rules/prompt/evaluation-and-iteration.mdmarkdown6.3 KB
rules/prompt/mode-contract.ko.mdmarkdown14.7 KB
rules/prompt/mode-contract.mdmarkdown14.0 KB
rules/prompt/prompt-contract.ko.mdmarkdown6.8 KB
rules/prompt/prompt-contract.mdmarkdown6.1 KB
rules/prompt/prompt-pack-workflow.ko.mdmarkdown3.0 KB
rules/prompt/prompt-pack-workflow.mdmarkdown2.7 KB
rules/readme/mode-contract.ko.mdmarkdown8.1 KB
rules/readme/mode-contract.mdmarkdown7.1 KB
rules/readme/project-discovery.ko.mdmarkdown6.1 KB
rules/readme/project-discovery.mdmarkdown5.5 KB
rules/readme/section-design.ko.mdmarkdown5.5 KB
rules/readme/section-design.mdmarkdown4.9 KB
rules/readme/validation.ko.mdmarkdown2.9 KB
rules/readme/validation.mdmarkdown2.6 KB

rules/agents-md/rule-file-splitting.ko.md

View on GitHub
# 규칙 파일 분리

**목적**: 항상 로드되어야 하는 지침을 숨기지 않으면서, 같은 범위의 세부 내용을 인접한 `rules/` 디렉터리로 옮겨 관할 `AGENTS.md`를 간결하게 유지한다.

## 1. 분리 시점

기존 또는 작성 중인 `AGENTS.md`를 훑어보기 어려워졌거나, 합산 지침 예산을 지나치게 사용하거나, 일부 작업에만 적용되는 상세 절차를 담고 있을 때 이 규칙을 사용한다.

다음 순서로 판단한다.

1. 일반적이거나, 저장소에서 발견 가능하거나, 오래됐거나, 중복됐거나, 실질적 역할이 없는 텍스트를 삭제한다.
2. 실제 하위 트리 차이는 가장 가까운 정당한 중첩 `AGENTS.md`로 옮긴다.
3. 항상 필요한 범위, 권위, 명령, 안전 게이트, 중단 조건은 관할 `AGENTS.md`에 유지한다.
4. 같은 범위에 속하지만 조건부로만 필요한 세부 내용만 해당 `AGENTS.md` 옆의 `rules/*.md`로 옮긴다.

`rules/` 분리는 progressive disclosure 수단이지 admission test를 통과하지 못한 모든 내용을 보존하는 방법이 아니다.

## 2. 위치와 형태

루트 지침 파일의 경우:

```text
repository/
├── AGENTS.md
├── AGENTS.ko.md
└── rules/
    ├── architecture.md
    ├── architecture.ko.md
    ├── testing.md
    └── testing.ko.md
```

중첩 지침 파일의 경우, 규칙이 같은 하위 트리를 관할할 때만 해당 하위 트리에서 지침 파일 옆에 지원 규칙을 둔다. 기존의 인접한 `rules/` 디렉터리가 이미 지침 문서를 담고 있고 새 이름이 충돌하지 않을 때만 재사용한다. 제품 코드, 생성 파일, 또는 이미 다른 목적으로 쓰는 디렉터리에 에이전트 정책 Markdown을 섞지 않는다. 대신 저장소의 기존 지침 문서 위치를 사용하고 직접 링크한다.

`architecture-boundaries.md`, `testing.md`, `release-safety.md`처럼 판단 영역을 나타내는 설명적인 kebab-case 이름을 사용한다. `misc.md` 같은 포괄 파일은 만들지 않는다.

## 3. 로딩 계약

임의의 `rules/*.md` 파일이 런타임에서 자동 발견되거나 자동 import된다고 가정하지 않는다. 관할 `AGENTS.md`는 모든 지원 파일을 직접 링크하고 언제 읽어야 하는지 정확히 명시해야 한다.

좋은 예:

```markdown
## 조건부 규칙

- 테스트 인프라나 테스트 명령을 바꾸기 전에 `rules/testing.md`를 읽는다.
- 패키지 경계를 넘어 코드를 옮기기 전에 `rules/architecture-boundaries.md`를 읽는다.
```

각 항목은 지원 파일로 가는 Markdown 링크 하나와 그 파일을 읽어야 하는 조건으로 이루어진다. 위에 나온 경로는 대상 저장소 내부의 예시 경로이므로, 이 package에서는 해석되지 않을 링크 대신 code span으로 표기한다.

“`rules/` 참고” 같은 모호한 안내를 사용하지 않는다. 대상 런타임과 문법을 명시적으로 검증하지 않았다면 공유 `AGENTS.md`에서 런타임 전용 import 문법을 사용하지 않는다. 일반 Markdown 링크와 읽기 조건을 함께 쓰는 것이 이식 가능한 기본값이다.

링크된 파일은 조건부 context이므로 필수 범위, 권위, 안전, 필수 명령, 완료 게이트를 `AGENTS.md` 밖으로 옮기지 않는다. 지원 규칙을 하나도 열지 않은 상태에서도 core는 안전하고 실행 가능해야 한다.

## 4. 정본 소유권

각 규칙의 정본 위치는 하나다.

| 내용 | 위치 |
|---|---|
| 항상 필요한 저장소 계약 | 관할 `AGENTS.md` |
| 하위 트리 전용 차이 | 가장 가까운 정당한 중첩 `AGENTS.md` |
| 같은 범위에서 일치하는 작업에만 쓰는 상세 정책이나 절차 | 인접한 `rules/*.md` |
| 이미 다른 곳에서 관리되는 상세 architecture 또는 API 지식 | 직접 링크한 기존 프로젝트 문서 |
| 결정적 강제 | hook, CI, lint 규칙, schema, 실행 가능 설정 |

최소한의 routing 안내를 제외하고 지원 규칙을 core에 다시 요약하지 않는다. 루트 또는 중첩 지침을 되풀이하는 지원 파일을 만들지 않는다.

## 5. 언어 쌍

에이전트가 로드하는 규칙 파일은 관할 `AGENTS.md`와 같은 언어로 작성한다. 루트 `AGENTS.md`가 이 skill의 기본 영어 정본과 한국어 미러 계약을 따를 때, 새로 만들거나 실질적으로 변경한 각 `rules/name.md`에 `rules/name.ko.md`를 짝으로 둔다. `AGENTS.md`의 링크는 영어 파일을, `AGENTS.ko.md`의 링크는 한국어 미러를 가리킨다.

중첩 규칙 미러는 관할 중첩 `AGENTS.md`에 선택한 것과 같은 정책을 따른다. 번역 사이에서 명령, 경로, 식별자, 규범 강도를 보존한다.

## 6. 검증 게이트

- [ ] 지원 규칙을 만들기 전에 삭제와 중첩 배치를 검토했다.
- [ ] `rules/` 디렉터리가 관할 `AGENTS.md` 옆에 있거나 기존의 문서화된 지침 위치를 대신 사용했다.
- [ ] 모든 지원 파일에 하나의 책임, 직접 링크, 명시적인 읽기 조건이 있다.
- [ ] 항상 로드되어야 하는 필수 계약을 `AGENTS.md` 밖으로 옮기지 않았다.
- [ ] 지원 규칙이 루트, 중첩, 기존 프로젝트 문서를 중복하지 않는다.
- [ ] 기존의 비문서용 `rules/` 내용을 덮어쓰거나 에이전트 정책과 섞지 않았다.
- [ ] 미러가 필요할 때 영어/한국어 링크가 의미상 정렬된 파일로 해석된다.
- [ ] 루트와 적용 가능한 중첩 지침 파일이 설정된 런타임 예산에서 여유를 유지한다.

## Sources

> 링크 확인 2026-09-21. 이 파일에는 외부 출처를 사용하지 않았습니다.

| 주장 | 출처 |
|---|---|
| 이 파일의 분리·배치·로딩·소유권·언어 규칙 | `instructions/skill/` 아래의 저장소 skill 저작 기준과 이 package의 `SKILL.md`. 벤더 문서나 웹 출처는 인용하지 않는다 |
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 197kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 197kUpdated Claude CodeCodexVerifiedInstall