diff --git a/.github/ISSUE_TEMPLATE/installation_problem.yml b/.github/ISSUE_TEMPLATE/installation_problem.yml
new file mode 100644
index 0000000..db9eb28
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/installation_problem.yml
@@ -0,0 +1,72 @@
+name: Installation problem
+description: Report a reproducible installation, loading, or skill-discovery problem.
+title: "[Installation]: "
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Do not include unpublished manuscripts, API keys, private paths, personal data, or other secrets. Replace local usernames and directories with neutral placeholders.
+ - type: input
+ id: version
+ attributes:
+ label: Humanities Superpowers version or commit
+ placeholder: e.g., v1.0.0 or commit SHA
+ validations:
+ required: true
+ - type: dropdown
+ id: harness
+ attributes:
+ label: Agent harness
+ options:
+ - Claude Code
+ - OpenAI Codex
+ - Cursor
+ - Manual Markdown use
+ - Other
+ validations:
+ required: true
+ - type: input
+ id: os
+ attributes:
+ label: Operating system
+ placeholder: e.g., Windows 11, macOS 15, Ubuntu 24.04
+ validations:
+ required: true
+ - type: textarea
+ id: layout
+ attributes:
+ label: Installation layout
+ description: Show the relevant folder structure with private path segments removed.
+ render: shell
+ validations:
+ required: true
+ - type: textarea
+ id: expected
+ attributes:
+ label: Expected behavior
+ validations:
+ required: true
+ - type: textarea
+ id: actual
+ attributes:
+ label: Actual behavior or error message
+ validations:
+ required: true
+ - type: textarea
+ id: reproduce
+ attributes:
+ label: Minimal reproduction steps
+ validations:
+ required: true
+ - type: textarea
+ id: checks
+ attributes:
+ label: Validation commands already run
+ placeholder: python3 scripts/validate_repository.py
+ - type: checkboxes
+ id: privacy
+ attributes:
+ label: Public-report check
+ options:
+ - label: I have removed secrets, private paths, personal data, and unpublished research material.
+ required: true
diff --git a/.github/ISSUE_TEMPLATE/methodological_criticism.yml b/.github/ISSUE_TEMPLATE/methodological_criticism.yml
new file mode 100644
index 0000000..4ad788b
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/methodological_criticism.yml
@@ -0,0 +1,60 @@
+name: Methodological criticism
+description: Identify a conceptual, disciplinary, or methodological weakness in the framework.
+title: "[Methodological criticism]: "
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Strong criticism is welcome. Please focus on claims, procedures, evidence standards, and disciplinary assumptions rather than persons.
+ - type: input
+ id: discipline
+ attributes:
+ label: Discipline or methodological perspective
+ placeholder: e.g., archival history, textual scholarship, philosophy, postcolonial studies
+ validations:
+ required: true
+ - type: dropdown
+ id: target
+ attributes:
+ label: Main target of criticism
+ options:
+ - A specific research skill
+ - Quality gates
+ - Router or rollback logic
+ - Human-AI responsibility model
+ - Documentation or terminology
+ - Framework as a whole
+ validations:
+ required: true
+ - type: input
+ id: target_name
+ attributes:
+ label: Specific file, skill, or claim
+ placeholder: e.g., performing-close-reading or PASS criteria
+ - type: textarea
+ id: criticism
+ attributes:
+ label: Methodological criticism
+ description: State the problem as precisely as possible.
+ validations:
+ required: true
+ - type: textarea
+ id: risk
+ attributes:
+ label: Scholarly risk created by this problem
+ description: Explain what the framework may distort, exclude, oversimplify, or falsely stabilize.
+ validations:
+ required: true
+ - type: textarea
+ id: counterexample
+ attributes:
+ label: Counterexample, alternative method, or proposed revision
+ validations:
+ required: true
+ - type: checkboxes
+ id: privacy
+ attributes:
+ label: Public-report check
+ options:
+ - label: I have removed confidential, personal, unpublished, and copyrighted material from this report.
+ required: true
diff --git a/.github/ISSUE_TEMPLATE/test_report.yml b/.github/ISSUE_TEMPLATE/test_report.yml
new file mode 100644
index 0000000..8c8efc9
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/test_report.yml
@@ -0,0 +1,65 @@
+name: Test report
+description: Report what happened when you tested one Humanities Superpowers skill on a real research project.
+title: "[Test report]: "
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thank you for critically testing Humanities Superpowers. Do not include unpublished manuscripts, personal data, reviewer identities, or copyrighted source text. Use anonymized descriptions and minimal excerpts.
+ - type: input
+ id: discipline
+ attributes:
+ label: Discipline or research area
+ placeholder: e.g., literary studies, history, philosophy, digital humanities
+ validations:
+ required: true
+ - type: input
+ id: skill
+ attributes:
+ label: Skill tested
+ placeholder: e.g., auditing-citations
+ validations:
+ required: true
+ - type: dropdown
+ id: harness
+ attributes:
+ label: Agent harness
+ options:
+ - Claude Code
+ - OpenAI Codex
+ - Cursor
+ - Manual Markdown use
+ - Other
+ validations:
+ required: true
+ - type: textarea
+ id: context
+ attributes:
+ label: Research context and task
+ description: Describe the task without sharing confidential or copyrighted material.
+ validations:
+ required: true
+ - type: textarea
+ id: outcome
+ attributes:
+ label: What happened
+ description: Report the route, gate result, useful behavior, and failure or friction you observed.
+ validations:
+ required: true
+ - type: textarea
+ id: weakness
+ attributes:
+ label: Where was the framework too rigid, too technical, or methodologically weak?
+ validations:
+ required: true
+ - type: textarea
+ id: improvement
+ attributes:
+ label: Suggested improvement or counterexample
+ - type: checkboxes
+ id: privacy
+ attributes:
+ label: Public-report check
+ options:
+ - label: I have removed confidential, personal, unpublished, and copyrighted material from this report.
+ required: true
diff --git a/MANIFEST.json b/MANIFEST.json
index b983f87..a878fa0 100644
--- a/MANIFEST.json
+++ b/MANIFEST.json
@@ -1,7 +1,7 @@
{
"name": "humanities-superpowers",
"version": "1.0.0",
- "file_count": 143,
+ "file_count": 146,
"files": [
{
"path": ".claude-plugin/plugin.json",
@@ -48,6 +48,16 @@
"sha256": "17c088d2b07a672208a51b421de1be2bd792994bdcc5f807dc27c1a78033d277",
"bytes": 493
},
+ {
+ "path": ".github/ISSUE_TEMPLATE/installation_problem.yml",
+ "sha256": "70c5e7196cc6146edfefd8bf63f17430af2e5aadaca41d76ea098a91bfcfb9de",
+ "bytes": 1966
+ },
+ {
+ "path": ".github/ISSUE_TEMPLATE/methodological_criticism.yml",
+ "sha256": "764d5ebf3640342d152d945f7b10e5538af6bcd67f9f5313e49151a22ccac336",
+ "bytes": 1950
+ },
{
"path": ".github/ISSUE_TEMPLATE/skill_improvement.yml",
"sha256": "2a308eb0ac7cc41f40e9641596749f1d5652205fe15cc78bb3da1aa0e55508d5",
@@ -58,6 +68,11 @@
"sha256": "33c06792faccee361f34d3a54795928957bb72c1cad29c2eb7494accaa3f436a",
"bytes": 997
},
+ {
+ "path": ".github/ISSUE_TEMPLATE/test_report.yml",
+ "sha256": "6ac65fe2b871ade02db27d2f6f04b58a206fc792a4172cfffacb1679c23c8be9",
+ "bytes": 2000
+ },
{
"path": ".github/pull_request_template.md",
"sha256": "5dbfadd78d7edfe904d65556680f708deaeebbdf5a96e611dc17bebe4dc8b08a",
@@ -88,31 +103,6 @@
"sha256": "d5f25c5a9a7298462ce019924603976d884b07f6ae1d1dc2ae4ca1ab3f4905d5",
"bytes": 963
},
- {
- "path": "assets/human-ai-collaboration.svg",
- "sha256": "00d910d1cc6c653d7727b7b13534b34dc76f7c55141679f8a608b0ac15edd05f",
- "bytes": 2489
- },
- {
- "path": "assets/quality-gates.svg",
- "sha256": "ad1dc05731f43b9312e4d409a865d905b2b6af214c87bf7bcfbccc0bb53979e1",
- "bytes": 3246
- },
- {
- "path": "assets/research-lifecycle.svg",
- "sha256": "5470bb1c8940fbd63a6b56b8e271ba4f2087cf30ff5afe71b2af6e3b1e89f5bd",
- "bytes": 2027
- },
- {
- "path": "assets/research-pipeline.svg",
- "sha256": "2b0523c2c1f0993f0189c8a91615b17655d3e57d22d10edb15485201764ec411",
- "bytes": 2443
- },
- {
- "path": "assets/skill-map.svg",
- "sha256": "717ab9f3ce60ceb839bd8855cd7fc1565c3f1f81b53626d67110be8806c99749",
- "bytes": 3919
- },
{
"path": "CHANGELOG.md",
"sha256": "464ef94397366f785e906ea072d7e92221a64496be4fdcc2ed3cd0fb5d77afa4",
@@ -143,6 +133,76 @@
"sha256": "04eb0705c232b1db1e54530e3be25db7c7385376f3f582fb81d6b199cf7f7af8",
"bytes": 2297
},
+ {
+ "path": "INSTALLATION.md",
+ "sha256": "b5a9327c5c69ecab50f6a4043da700dcc8dbb75cf8f4b8e062c04ae72a26678b",
+ "bytes": 5142
+ },
+ {
+ "path": "LICENSE",
+ "sha256": "3e2e4db37e48d28d5b4925edf729f05b77fec01f5ed92f0e776a6f41c8e9da4e",
+ "bytes": 1070
+ },
+ {
+ "path": "MANIFESTO.md",
+ "sha256": "56c72e5d5b291a4ed317ab1c5f698014fff45f3a279f6d34b7a1d5b2864eeb81",
+ "bytes": 1049
+ },
+ {
+ "path": "PUBLISHING_CHECKLIST.md",
+ "sha256": "8f1fad9fb1318689de110fea92947d08cdfdfdb4a0fb321b8978e1ff44834514",
+ "bytes": 1010
+ },
+ {
+ "path": "README.ko.md",
+ "sha256": "4b60afa3b9cdab9cd90ee35de18313765982af51fa4b95791339077d1f484d6c",
+ "bytes": 8730
+ },
+ {
+ "path": "README.md",
+ "sha256": "3b47bf3e1e10345bda73a461649cbdcce7d319b144fec3c74746548e6a15c7ae",
+ "bytes": 9442
+ },
+ {
+ "path": "ROADMAP.md",
+ "sha256": "aea8f678b5b7bec6266e746d8ab9af0dda2ee63ae0c3d28ce2d3f0b4e96132bb",
+ "bytes": 762
+ },
+ {
+ "path": "SECURITY.md",
+ "sha256": "9fa704d709a5c0dfd9fbc9265c154825738dda20cf5410922cd30d12c8be75f1",
+ "bytes": 619
+ },
+ {
+ "path": "THIRD_PARTY_NOTICES.md",
+ "sha256": "50c0549c92432e9b4d6edef6ceb1ebf434705e1365e14d5dec09c383654a7767",
+ "bytes": 756
+ },
+ {
+ "path": "assets/human-ai-collaboration.svg",
+ "sha256": "00d910d1cc6c653d7727b7b13534b34dc76f7c55141679f8a608b0ac15edd05f",
+ "bytes": 2489
+ },
+ {
+ "path": "assets/quality-gates.svg",
+ "sha256": "ad1dc05731f43b9312e4d409a865d905b2b6af214c87bf7bcfbccc0bb53979e1",
+ "bytes": 3246
+ },
+ {
+ "path": "assets/research-lifecycle.svg",
+ "sha256": "5470bb1c8940fbd63a6b56b8e271ba4f2087cf30ff5afe71b2af6e3b1e89f5bd",
+ "bytes": 2027
+ },
+ {
+ "path": "assets/research-pipeline.svg",
+ "sha256": "2b0523c2c1f0993f0189c8a91615b17655d3e57d22d10edb15485201764ec411",
+ "bytes": 2443
+ },
+ {
+ "path": "assets/skill-map.svg",
+ "sha256": "717ab9f3ce60ceb839bd8855cd7fc1565c3f1f81b53626d67110be8806c99749",
+ "bytes": 3919
+ },
{
"path": "docs/ANTI_PATTERNS.md",
"sha256": "78c0458061918847a96407a3f59b0a3402e636126fbb720147b18976711fd183",
@@ -158,6 +218,21 @@
"sha256": "9a0ff5284dee42609b6b92221dd0aec622e11b5ba1805f6565e18ba26488ff26",
"bytes": 850
},
+ {
+ "path": "docs/PHILOSOPHY.md",
+ "sha256": "cd138ee4be6973b43540dd97648197eafc136c01bae75f4ed231907793391eba",
+ "bytes": 1307
+ },
+ {
+ "path": "docs/QUALITY_GATES.md",
+ "sha256": "b0ad43e92df88cf4e25ab059abaf08710b8347c8b7b309743f4663b37a779768",
+ "bytes": 732
+ },
+ {
+ "path": "docs/SKILL_SCHEMA.md",
+ "sha256": "878352f811f379e9a96575373afd232888dbe404062da13a263eb34fcae4ace8",
+ "bytes": 1010
+ },
{
"path": "docs/integration/INTEGRATED_CONFORMANCE.md",
"sha256": "2d36f9d5073f53e7fb82e03b224bf05d2ff7c1193102302747a29bddcb0a0c8c",
@@ -188,16 +263,6 @@
"sha256": "13400d8768aadb233f3845873b286a3b07269892e273d6a62801b8711eb593f0",
"bytes": 1187
},
- {
- "path": "docs/PHILOSOPHY.md",
- "sha256": "cd138ee4be6973b43540dd97648197eafc136c01bae75f4ed231907793391eba",
- "bytes": 1307
- },
- {
- "path": "docs/QUALITY_GATES.md",
- "sha256": "b0ad43e92df88cf4e25ab059abaf08710b8347c8b7b309743f4663b37a779768",
- "bytes": 732
- },
{
"path": "docs/release/PRE_PUBLICATION_OPTIMIZATION_REPORT.md",
"sha256": "00208256012821723c4545a8bfe61679b5c60f7583e9e2ae03eb452df91db7ac",
@@ -213,11 +278,6 @@
"sha256": "5ce57d72225aa580f3e58dbe11ba6460840b14621ae516aa925ac421414ab53b",
"bytes": 1034
},
- {
- "path": "docs/SKILL_SCHEMA.md",
- "sha256": "878352f811f379e9a96575373afd232888dbe404062da13a263eb34fcae4ace8",
- "bytes": 1010
- },
{
"path": "docs/social-media-kit/LAUNCH_SEQUENCE.md",
"sha256": "4ea188b93a214bb41e38220c3565524cac2b7f639e82766ca89fd713dca28852",
@@ -283,21 +343,26 @@
"sha256": "b1d1983460fc24fbffa60c5edd5ebc7cf8310fdeb6a6e688360901274b8e1cf0",
"bytes": 2935
},
- {
- "path": "docs/white-paper/citation-audit.md",
- "sha256": "a6ae5bf40251f92fedad13c5fe31e29ba1fe4b6fae47d88388810f47f4aa998e",
- "bytes": 4496
- },
{
"path": "docs/white-paper/HUMANITIES_SUPERPOWERS_WHITE_PAPER.md",
"sha256": "3788dd782cb94a85ab398525cffd31ab1af5e81c38da075982c58daf9c5c5266",
"bytes": 36769
},
+ {
+ "path": "docs/white-paper/citation-audit.md",
+ "sha256": "a6ae5bf40251f92fedad13c5fe31e29ba1fe4b6fae47d88388810f47f4aa998e",
+ "bytes": 4496
+ },
{
"path": "examples/argument-map-example/README.md",
"sha256": "d83ae3d5dea1f7681d9ee640f4f7b2b0d7b0d4eee351415946a36a8f89ec5d16",
"bytes": 1459
},
+ {
+ "path": "examples/concept-paper-example/README.md",
+ "sha256": "1ab0d16bae948d8a020c752403d15b2d865a630d83f9fbd0833807c089dfc148",
+ "bytes": 854
+ },
{
"path": "examples/concept-paper-example/input/research-brief.md",
"sha256": "4b3ce37d2543e06e493a4baf62d9c8d59c433115ef4273baee24e99b7c153cd6",
@@ -339,9 +404,9 @@
"bytes": 1134
},
{
- "path": "examples/concept-paper-example/README.md",
- "sha256": "1ab0d16bae948d8a020c752403d15b2d865a630d83f9fbd0833807c089dfc148",
- "bytes": 854
+ "path": "examples/end-to-end-research-session/README.md",
+ "sha256": "a4208e65fd7c9f4124cca23f5c43d7c9a736f79f461adf6533a30f31157afa40",
+ "bytes": 926
},
{
"path": "examples/end-to-end-research-session/gate-history.md",
@@ -353,11 +418,6 @@
"sha256": "d1fe762b4988b0c9678ebd7bbbbe2bad0dc269e4a4e392c055ad73073298470c",
"bytes": 472
},
- {
- "path": "examples/end-to-end-research-session/README.md",
- "sha256": "a4208e65fd7c9f4124cca23f5c43d7c9a736f79f461adf6533a30f31157afa40",
- "bytes": 926
- },
{
"path": "examples/end-to-end-research-session/session-01.json",
"sha256": "71fa9e99280bcf1b0579843a47d5c54fb20c26886a4467ba7641c0ab7fc9bc55",
@@ -368,21 +428,6 @@
"sha256": "c615809b66c747069fca88bd8b307394d256414fe0e96783a211955575405e4e",
"bytes": 1709
},
- {
- "path": "INSTALLATION.md",
- "sha256": "b5a9327c5c69ecab50f6a4043da700dcc8dbb75cf8f4b8e062c04ae72a26678b",
- "bytes": 5142
- },
- {
- "path": "LICENSE",
- "sha256": "3e2e4db37e48d28d5b4925edf729f05b77fec01f5ed92f0e776a6f41c8e9da4e",
- "bytes": 1070
- },
- {
- "path": "MANIFESTO.md",
- "sha256": "56c72e5d5b291a4ed317ab1c5f698014fff45f3a279f6d34b7a1d5b2864eeb81",
- "bytes": 1049
- },
{
"path": "mkdocs.yml",
"sha256": "604aa49b5bfa4578409b52855fd91b9e87a8cc8893c3c6e11f85c048c52dee62",
@@ -393,26 +438,6 @@
"sha256": "2f4aea6ed58d95174a94b59a9b7f5399ab95f16ab21718ed819b1811d264974f",
"bytes": 372
},
- {
- "path": "PUBLISHING_CHECKLIST.md",
- "sha256": "8f1fad9fb1318689de110fea92947d08cdfdfdb4a0fb321b8978e1ff44834514",
- "bytes": 1010
- },
- {
- "path": "README.ko.md",
- "sha256": "1ffe23596e1ba788a542bf520831ae0542dc71a56e4f04284a62161c4c705ab0",
- "bytes": 7435
- },
- {
- "path": "README.md",
- "sha256": "edcdf5cfe00ab801d9fe4ecb9d356fb263f2827ef33b4c5dc358691fefecaea9",
- "bytes": 8237
- },
- {
- "path": "ROADMAP.md",
- "sha256": "aea8f678b5b7bec6266e746d8ab9af0dda2ee63ae0c3d28ce2d3f0b4e96132bb",
- "bytes": 762
- },
{
"path": "schemas/gate-report.schema.json",
"sha256": "25ed42cfa2dc141adb37a339b431b961110d0ab780f54e75e411dca0899839c1",
@@ -454,20 +479,20 @@
"bytes": 19841
},
{
- "path": "SECURITY.md",
- "sha256": "9fa704d709a5c0dfd9fbc9265c154825738dda20cf5410922cd30d12c8be75f1",
- "bytes": 619
+ "path": "site/docs/CODE_OF_CONDUCT.md",
+ "sha256": "f9ebc4e13b98b32559a92dedf177ca3400dc41fe83cdb28b80c6d976da25e94c",
+ "bytes": 672
+ },
+ {
+ "path": "site/docs/THIRD_PARTY_NOTICES.md",
+ "sha256": "50c0549c92432e9b4d6edef6ceb1ebf434705e1365e14d5dec09c383654a7767",
+ "bytes": 756
},
{
"path": "site/docs/acknowledgments.md",
"sha256": "64c4022e58db25b7f1517924fe43248f56ae21c24ec2f9327d25faebd8902f73",
"bytes": 1828
},
- {
- "path": "site/docs/CODE_OF_CONDUCT.md",
- "sha256": "f9ebc4e13b98b32559a92dedf177ca3400dc41fe83cdb28b80c6d976da25e94c",
- "bytes": 672
- },
{
"path": "site/docs/contributing.md",
"sha256": "fb0b47cb06942a7e535c1815b8528a1e0d53f5baa7c557214c176992d1e77122",
@@ -513,11 +538,6 @@
"sha256": "4ea188b93a214bb41e38220c3565524cac2b7f639e82766ca89fd713dca28852",
"bytes": 1857
},
- {
- "path": "site/docs/release/social-launch.md",
- "sha256": "963d90aea3a35787fa6a632b752953c8e3f36a364f1ba29ff1913bd2e01ba880",
- "bytes": 363
- },
{
"path": "site/docs/release/SOCIAL_LAUNCH_EN.md",
"sha256": "74f3907d829cab15fb4ee6b0ea3852f8ff8021cd31525aedfb3e8f6bb6a36a43",
@@ -528,6 +548,11 @@
"sha256": "ecc93ce65325f11bed09574b9e4015541e4ce62deda16701988dec49c4e1d253",
"bytes": 8130
},
+ {
+ "path": "site/docs/release/social-launch.md",
+ "sha256": "963d90aea3a35787fa6a632b752953c8e3f36a364f1ba29ff1913bd2e01ba880",
+ "bytes": 363
+ },
{
"path": "site/docs/skills.md",
"sha256": "56333b8c52b9c1bfd90b25c846a42f47c97d94d61bf0d9521b14049a7fd8c32b",
@@ -538,11 +563,6 @@
"sha256": "e52083c1ea6d55e1733a3d5496f607338d4e38437532d18c52a7c6de2383b29b",
"bytes": 3918
},
- {
- "path": "site/docs/THIRD_PARTY_NOTICES.md",
- "sha256": "50c0549c92432e9b4d6edef6ceb1ebf434705e1365e14d5dec09c383654a7767",
- "bytes": 756
- },
{
"path": "site/docs/white-paper.md",
"sha256": "cd4980f418b3148c8a603cde8d1ae584914c12f7c13565abf9bfa8ed5197cc05",
@@ -698,11 +718,6 @@
"sha256": "869c0e65944c194130036d8f33a59e69a657338b53f8099f4a846aa917b98eeb",
"bytes": 1675
},
- {
- "path": "THIRD_PARTY_NOTICES.md",
- "sha256": "50c0549c92432e9b4d6edef6ceb1ebf434705e1365e14d5dec09c383654a7767",
- "bytes": 756
- },
{
"path": "workflows/respond-to-reviewers.md",
"sha256": "ceec392cd28c06f8757d895f31aade5c70fb81ba8d29591c7282ebeef86ccaee",
diff --git a/README.ko.md b/README.ko.md
index 4bdd316..8ffc890 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -1,15 +1,27 @@
# Humanities Superpowers
-[English](README.md) · [설치](INSTALLATION.md) · [방법론 백서](docs/white-paper/HUMANITIES_SUPERPOWERS_WHITE_PAPER.md) · [선언문](MANIFESTO.md)
+[English](README.md) · [문서 사이트](https://icerain-cmd.github.io/humanities-superpowers/) · [설치](INSTALLATION.md) · [방법론 백서](docs/white-paper/HUMANITIES_SUPERPOWERS_WHITE_PAPER.md) · [선언문](MANIFESTO.md)
**AI 에이전트를 사용하는 인문학 연구자를 위한 구조화된 연구 스킬과 품질 게이트입니다.**
-> **AI 논문 대필 도구가 아니라, 학술적 판단을 지지하는 발판입니다.**
+> **학술적 판단을 포기하지 않고 AI를 사용하십시오.**
+> AI 논문 대필 도구가 아니라, 학술적 판단을 지지하는 발판입니다.
Humanities Superpowers는 유창한 AI 산출물이 가장 위험해지는 순간을 늦추고 점검합니다. 연구 질문 형성, 개념 정의, 주장과 근거 연결, 반론 검토, 인용 검증, 제출 가능 여부 판단을 명시적인 절차로 바꿉니다.
13개 핵심 연구 스킬과 그중 필요한 최소 경로를 선택하는 1개의 Level 3 라우터를 제공합니다. AI는 정리하고 비교하며 문제를 표시할 수 있지만, 해석, 출처 확인, 윤리적 판단, 개념적 선택, 최종 저자 책임을 대신하거나 원고의 게재 가능 상태를 보장하지 않습니다.
+## 비판적 테스트 참여 요청
+
+첫 목표는 실제 연구 프로젝트에서 하나의 연구 스킬을 시험하고, 이 프레임워크가 **지나치게 경직되었거나 기술 중심적이거나 방법론적으로 취약한 지점**을 알려 줄 인문학 연구자 10명을 모집하는 것입니다.
+
+- [테스트 보고서 제출](https://github.com/icerain-cmd/humanities-superpowers/issues/new?template=test_report.yml)
+- [방법론적 비판 제기](https://github.com/icerain-cmd/humanities-superpowers/issues/new?template=methodological_criticism.yml)
+- [설치 문제 보고](https://github.com/icerain-cmd/humanities-superpowers/issues/new?template=installation_problem.yml)
+- [자유 토론 참여](https://github.com/icerain-cmd/humanities-superpowers/discussions)
+
+문학·역사·철학 연구자, 디지털인문학 연구자와 사서, 대학원생, 비영어권 연구자의 참여를 특히 환영합니다. 공개되지 않은 원고, 개인정보, 심사자 신원, 저작권이 있는 원문은 게시하지 말고 익명화한 설명과 최소한의 인용만 사용하십시오.
+
## 빠른 시작
@@ -110,7 +122,6 @@ MIT License로 공개합니다.
기여 전에 [CONTRIBUTING.md](CONTRIBUTING.md)를 읽어 주십시오. 인용 정보는 [CITATION.cff](CITATION.cff), 라이선스 전문은 [LICENSE](LICENSE)에서 확인할 수 있습니다.
-
## 연구 오케스트레이션
Level 3 라우터는 현재 연구 상태를 진단하고, 필요한 최소 스킬 경로를 선택하며, 실패한 게이트를 숨기지 않고 중단·되돌림의 근거로 사용합니다. 명시적인 세션 기록으로 작업을 이어갈 수 있지만, 그 기록을 학술적 근거로 취급하지 않습니다.
@@ -121,13 +132,12 @@ Level 3 라우터는 현재 연구 상태를 진단하고, 필요한 최소 스
## 문서 사이트
-GitHub Pages 배포를 위한 MkDocs Material 사이트가 포함되어 있습니다. 저장소의 **Settings → Pages → GitHub Actions**를 활성화하면 `main` 브랜치 변경 시 자동 배포됩니다.
+공개 문서는 [icerain-cmd.github.io/humanities-superpowers](https://icerain-cmd.github.io/humanities-superpowers/)에서 볼 수 있습니다. MkDocs Material로 구성되며 `main` 브랜치에서 GitHub Actions를 통해 배포됩니다.
## 공개 릴리스 상태
v1.0.0 릴리스 노트와 최종 공개 체크리스트는 [`docs/release/`](docs/release/)에서 확인할 수 있습니다.
-
## SNS 공개문 모음
- [SNS 공개문 모음](docs/social-media-kit/README.md)
diff --git a/README.md b/README.md
index 31b500c..0fa9a1a 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,27 @@
# Humanities Superpowers
-[한국어](README.ko.md) · [Quick start](INSTALLATION.md) · [White paper](docs/white-paper/HUMANITIES_SUPERPOWERS_WHITE_PAPER.md) · [Manifesto](MANIFESTO.md) · [Examples](#worked-examples)
+[한국어](README.ko.md) · [Documentation](https://icerain-cmd.github.io/humanities-superpowers/) · [Quick start](INSTALLATION.md) · [White paper](docs/white-paper/HUMANITIES_SUPERPOWERS_WHITE_PAPER.md) · [Manifesto](MANIFESTO.md) · [Examples](#worked-examples)
**Structured research skills and quality gates for humanities scholars using AI agents.**
-> **Not an AI paper writer. A scholarly judgment scaffold.**
+> **Use AI without surrendering scholarly judgment.**
+> Not an AI paper writer. A scholarly judgment scaffold.
Humanities Superpowers helps researchers slow down the moments where fluent AI output is most dangerous: framing a question, defining concepts, connecting claims to evidence, testing objections, checking citations, and deciding whether a manuscript is ready to submit.
It provides 13 core research skills and one Level 3 router that selects the smallest valid route through them. It supports scholarly judgment; it does not replace interpretation, source verification, ethics, or authorship, and it does not promise a publication-ready manuscript.
+## Critical testing invited
+
+The initial goal is to recruit **10 humanities researchers** willing to test one research skill on a real project and report where the framework is too rigid, too technical, or methodologically weak.
+
+- [Submit a test report](https://github.com/icerain-cmd/humanities-superpowers/issues/new?template=test_report.yml)
+- [Offer methodological criticism](https://github.com/icerain-cmd/humanities-superpowers/issues/new?template=methodological_criticism.yml)
+- [Report an installation problem](https://github.com/icerain-cmd/humanities-superpowers/issues/new?template=installation_problem.yml)
+- [Join a broader discussion](https://github.com/icerain-cmd/humanities-superpowers/discussions)
+
+Literary scholars, historians, philosophers, digital humanists, DH librarians, graduate researchers, and scholars working in languages other than English are especially welcome. Do not post unpublished manuscripts, personal data, reviewer identities, or copyrighted source text; use anonymized descriptions and minimal excerpts.
+
## Quick start
@@ -128,7 +140,6 @@ GitHub: [`@icerain-cmd`](https://github.com/icerain-cmd) · [icerain@jj.ac.kr](m
Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening an issue or pull request. Citation metadata is provided in [CITATION.cff](CITATION.cff). Released under the [MIT License](LICENSE).
-
## Research orchestration
The Level 3 router diagnoses the current research state, selects the smallest valid skill route, and treats failed gates as reasons to pause or roll back—not as obstacles to hide. It can preserve a resumable session record without treating memory as evidence.
@@ -139,13 +150,12 @@ The Level 3 router diagnoses the current research state, selects the smallest va
## Documentation site
-The repository includes a MkDocs Material site configured for GitHub Pages. After enabling **Settings → Pages → GitHub Actions**, pushes to `main` deploy the documentation automatically.
+The live documentation is published at [icerain-cmd.github.io/humanities-superpowers](https://icerain-cmd.github.io/humanities-superpowers/). It is built with MkDocs Material and deployed from `main` through GitHub Actions.
## Public release status
The v1.0.0 release notes and final publication checklist are available in [`docs/release/`](docs/release/).
-
## Social media launch kit
- [Social media launch kit](docs/social-media-kit/README.md)