Skip to content

Commit 06f5644

Browse files
SoliEstrecodex
andcommitted
[Feat] IDD 에이전트 스킬과 플러그인 배포
- 공용 IDD 스킬과 구조 검사기, 양성·음성 fixture를 추가했습니다. - Codex·Claude Code·Gemini CLI 배포 manifest와 영어·한국어 설치 안내를 동기화했습니다. - validator PASS가 실행 허가가 아님을 명시하고 공개 경계 검사를 확장했습니다. Co-Authored-By: OpenAI Codex <codex@users.noreply.github.com>
1 parent 38848b3 commit 06f5644

29 files changed

Lines changed: 550 additions & 27 deletions

.claude-plugin/marketplace.json

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
{
2+
"name": "idd",
3+
"description": "Public IDD methods and agent skills from SoliEstre.",
4+
"owner": {
5+
"name": "SoliEstre"
6+
},
7+
"plugins": [
8+
{
9+
"name": "idd",
10+
"displayName": "Implementation-Driven Development",
11+
"source": "./",
12+
"description": "Use isolated implementations as evidence before human decisions create durable contracts.",
13+
"version": "0.1.0-draft",
14+
"author": {
15+
"name": "SoliEstre",
16+
"url": "https://github.com/SoliEstre"
17+
},
18+
"homepage": "https://soliestre.github.io/idd/",
19+
"repository": "https://github.com/SoliEstre/idd",
20+
"license": "MIT",
21+
"category": "development",
22+
"tags": ["methodology", "agent-skill", "prototyping"],
23+
"strict": true
24+
}
25+
]
26+
}

.claude-plugin/plugin.json

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"name": "idd",
3+
"version": "0.1.0-draft",
4+
"description": "Implementation-Driven Development skill for isolated probes, human decisions, contracts, and independent verification.",
5+
"author": {
6+
"name": "SoliEstre",
7+
"url": "https://github.com/SoliEstre"
8+
},
9+
"homepage": "https://soliestre.github.io/idd/",
10+
"repository": "https://github.com/SoliEstre/idd",
11+
"license": "MIT",
12+
"keywords": ["idd", "implementation-driven-development", "agent-skill"],
13+
"skills": "./skills/"
14+
}

.codex-plugin/plugin.json

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
{
2+
"name": "idd",
3+
"version": "0.1.0-draft",
4+
"description": "Route uncertain software behavior through isolated implementation probes, human decisions, contracts, and independent verification.",
5+
"author": {
6+
"name": "SoliEstre",
7+
"url": "https://github.com/SoliEstre"
8+
},
9+
"homepage": "https://soliestre.github.io/idd/",
10+
"repository": "https://github.com/SoliEstre/idd",
11+
"license": "MIT",
12+
"keywords": ["idd", "implementation-driven-development", "agent-skill", "software-development"],
13+
"skills": "./skills/",
14+
"interface": {
15+
"displayName": "Implementation-Driven Development",
16+
"shortDescription": "Turn uncertainty into isolated executable evidence.",
17+
"longDescription": "Route uncertain product behavior through one-question probes, explicit human decisions, durable contracts, official re-implementation, and independent verification.",
18+
"developerName": "SoliEstre",
19+
"category": "Developer Tools",
20+
"capabilities": ["Interactive"],
21+
"websiteURL": "https://soliestre.github.io/idd/",
22+
"defaultPrompt": [
23+
"Use IDD to probe this uncertain behavior safely.",
24+
"Route this task between IDD and contract-first work.",
25+
"Turn this probe evidence into a human decision gate."
26+
],
27+
"brandColor": "#7447FF"
28+
}
29+
}

AGENTS.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ This repository is the public surface of the IDD project. Keep every change safe
77
1. Read `README.md`, `docs/status.md`, and the document you will change.
88
2. Use English for the main document. Add or update the matching Korean document when the meaning changes.
99
3. Treat `ai/idd-spec.md` as a dense expert and machine-readable projection, not as permission to invent missing decisions.
10+
4. Treat `skills/idd/SKILL.md` as the canonical agent workflow. Keep Codex, Claude Code, Gemini CLI, and human documentation aligned with it.
1011

1112
## Public boundary
1213

@@ -29,10 +30,12 @@ This repository is the public surface of the IDD project. Keep every change safe
2930
- Do not promote a probe without a human decision and a matching test, contract, or evaluation.
3031
- Require a verifier that is independent from the implementation attempt before calling a change shippable.
3132
- Prefer a reproducible local check for every enforced gate.
33+
- Keep the skill agent-neutral. Put runtime-specific metadata in `.codex-plugin/`, `.claude-plugin/`, `gemini-extension.json`, or `skills/idd/agents/` rather than forking the workflow.
3234

3335
## Documentation checks
3436

3537
- Run `node scripts/validate-public.mjs` before committing or publishing.
38+
- Run the skill-structure validator and `node skills/idd/scripts/validate-probe.mjs <fixture>` when the skill or its artifact shape changes.
3639
- Keep English and Korean navigation valid.
3740
- Use relative links inside the repository when possible.
3841
- Keep the public README, site, `llms.txt`, and AI specification aligned on lifecycle and status.

README.ko.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
<a href="https://soliestre.github.io/idd/ko/"><img alt="GitHub Pages의 소개 사이트" src="https://img.shields.io/badge/site-GitHub%20Pages-7447FF?style=flat-square&amp;labelColor=12131A"></a>
1111
<a href="https://github.com/SoliEstre/idd/actions/workflows/validate.yml"><img alt="공개 콘텐츠 검증" src="https://github.com/SoliEstre/idd/actions/workflows/validate.yml/badge.svg?branch=main"></a>
1212
<a href="docs/ko/status.md"><img alt="프로젝트 상태: 연구 단계" src="https://img.shields.io/badge/status-research%20stage-FF826E?style=flat-square&amp;labelColor=12131A"></a>
13+
<a href="docs/ko/skills.md"><img alt="에이전트 스킬 버전 0.1.0 초안" src="https://img.shields.io/badge/agent%20skill-0.1.0--draft-F2D06B?style=flat-square&amp;labelColor=12131A"></a>
1314
<a href="LICENSE"><img alt="MIT 라이선스" src="https://img.shields.io/badge/license-MIT-AEF5D8?style=flat-square&amp;labelColor=12131A"></a>
1415
<a href="README.md"><img alt="영어로 읽기" src="https://img.shields.io/badge/read-EN-F3F0E8?style=flat-square&amp;labelColor=12131A"></a>
1516
</p>
@@ -57,13 +58,25 @@ IDD는 테스트 주도 개발을 대체하지 않습니다. 중요한 동작이
5758
- [IDD란 무엇인가](docs/ko/what-is-idd.md)
5859
- [작업 방법](docs/ko/method.md)
5960
- [안전 경계](docs/ko/safety.md)
61+
- [에이전트 스킬과 플러그인 지원](docs/ko/skills.md)
6062
- [프로젝트 상태](docs/ko/status.md)
6163
- [호스팅 결정](docs/ko/hosting.md)
6264
- [인공지능 시스템과 전문 독자를 위한 고밀도 사양](ai/idd-spec.md)
6365
- [영문 문서](docs/README.md)
6466

6567
소개 사이트는 [soliestre.github.io/idd](https://soliestre.github.io/idd/ko/)에서 공개합니다. 호스트에 종속되지 않는 원본은 [`site/`](site/)에 그대로 둡니다.
6668

69+
## 에이전트에서 사용하기
70+
71+
기준 [`skills/idd/SKILL.md`](skills/idd/SKILL.md)는 Codex, Claude Code와 Gemini CLI용으로 함께 패키징합니다. Claude Code에서는 이 저장소에서 바로 설치할 수 있습니다.
72+
73+
```text
74+
/plugin marketplace add SoliEstre/idd
75+
/plugin install idd@idd
76+
```
77+
78+
그다음 `/idd:idd`로 호출하거나 의미가 불명확한 제품·연동 작업을 설명해 자동 선택하게 합니다. Codex, Gemini CLI, GitHub Copilot, 검사 방법과 현재 배포 한계는 [에이전트 스킬과 플러그인 지원](docs/ko/skills.md)에 정리했습니다.
79+
6780
## 현재 한계와 이용 조건
6881

6982
IDD는 연구 단계 방법입니다. 실제 팀을 대상으로 IDD가 기존 방법보다 빠르거나 안전하거나 우수하다는 점을 아직 입증하지 않았습니다. 이는 홍보 문구가 아니라 통제된 파일럿으로 확인할 질문입니다.

README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
<a href="https://soliestre.github.io/idd/"><img alt="Introduction site on GitHub Pages" src="https://img.shields.io/badge/site-GitHub%20Pages-7447FF?style=flat-square&amp;labelColor=12131A"></a>
1111
<a href="https://github.com/SoliEstre/idd/actions/workflows/validate.yml"><img alt="Public surface validation" src="https://github.com/SoliEstre/idd/actions/workflows/validate.yml/badge.svg?branch=main"></a>
1212
<a href="docs/status.md"><img alt="Project status: research stage" src="https://img.shields.io/badge/status-research%20stage-FF826E?style=flat-square&amp;labelColor=12131A"></a>
13+
<a href="docs/skills.md"><img alt="Agent skill version 0.1.0 draft" src="https://img.shields.io/badge/agent%20skill-0.1.0--draft-F2D06B?style=flat-square&amp;labelColor=12131A"></a>
1314
<a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-AEF5D8?style=flat-square&amp;labelColor=12131A"></a>
1415
<a href="README.ko.md"><img alt="Read in Korean" src="https://img.shields.io/badge/read-KO-F3F0E8?style=flat-square&amp;labelColor=12131A"></a>
1516
</p>
@@ -57,13 +58,25 @@ IDD does not replace test-driven development. It is a route for work where the i
5758
- [What IDD is](docs/what-is-idd.md)
5859
- [The working method](docs/method.md)
5960
- [Safety boundaries](docs/safety.md)
61+
- [Agent skill and plugin support](docs/skills.md)
6062
- [Project status](docs/status.md)
6163
- [Hosting decision](docs/hosting.md)
6264
- [Dense specification for AI systems and expert readers](ai/idd-spec.md)
6365
- [Korean documentation](docs/ko/README.md)
6466

6567
The introduction site is published at [soliestre.github.io/idd](https://soliestre.github.io/idd/). Its host-neutral source remains in [`site/`](site/).
6668

69+
## Use it with an agent
70+
71+
The canonical [`skills/idd/SKILL.md`](skills/idd/SKILL.md) is packaged for Codex, Claude Code, and Gemini CLI. Claude Code can install it directly from this repository:
72+
73+
```text
74+
/plugin marketplace add SoliEstre/idd
75+
/plugin install idd@idd
76+
```
77+
78+
Then invoke `/idd:idd` or let Claude match an ambiguous product or integration task. See [agent skill and plugin support](docs/skills.md) for Codex, Gemini CLI, GitHub Copilot, validation, and current distribution limits.
79+
6780
## Current limits and terms
6881

6982
IDD is a research-stage method. The project has not yet shown that IDD is faster, safer, or better than established methods across real teams. Those are questions for controlled pilots, not marketing claims.

ai/idd-spec.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ status: research-draft
55
spec_version: 0.1.0-draft
66
primary_language: en
77
audience_profile: L5.5.5
8-
last_updated: 2026-08-06
8+
last_updated: 2026-08-08
99
license: MIT
1010
canonical_loop_name: unresolved
1111
---
@@ -219,15 +219,22 @@ The following is descriptive and intentionally not published as a stable JSON Sc
219219
"production_data": false,
220220
"irreversible_side_effects": false
221221
},
222-
"evidence_refs": [],
222+
"data_policy": {
223+
"classification": "synthetic|deidentified",
224+
"source": "fixture or reviewed de-identification record",
225+
"reviewer": "accountable human"
226+
},
227+
"run_command": "reproducible project command",
228+
"stop_condition": "accept, reject, defer, or another-probe threshold",
229+
"evidence_paths": ["repository-relative path"],
223230
"decision_ref": null,
224231
"contract_refs": [],
225232
"verification_ref": null,
226233
"promotion_ref": null
227234
}
228235
```
229236

230-
Field names, serialization, identifiers, and rejection states are unresolved. Consumers MUST NOT treat this example as a compatibility promise.
237+
Field names, serialization, identifiers, and rejection states are unresolved. Consumers MUST NOT treat this example as a compatibility promise. The draft validator checks structure and obvious placeholders only; it does not prove that a command is safe, data is de-identified, evidence exists, or execution is authorized.
231238

232239
## 8. Evidence quality
233240

@@ -316,7 +323,10 @@ documentation: present
316323
introduction_site_source: present
317324
introduction_site: deployed
318325
AI_dense_specification: present
319-
agent_skill_release: absent
326+
agent_skill_release: 0.1.0-draft
327+
codex_plugin_manifest: present
328+
claude_code_plugin_manifest: present
329+
gemini_cli_extension_manifest: present
320330
CLI_release: absent
321331
stable_schema: absent
322332
validated_production_workflow: absent

ai/index.json

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
"site": "https://soliestre.github.io/idd/",
77
"status": "research-draft",
88
"spec_version": "0.1.0-draft",
9-
"last_updated": "2026-08-06",
9+
"last_updated": "2026-08-08",
1010
"license": "MIT"
1111
},
1212
"audience_surfaces": {
@@ -41,14 +41,23 @@
4141
"no_unverified_superiority_claim",
4242
"public_boundary_integrity"
4343
],
44+
"agent_distribution": {
45+
"skill": "skills/idd/SKILL.md",
46+
"version": "0.1.0-draft",
47+
"codex_manifest": ".codex-plugin/plugin.json",
48+
"claude_code_manifest": ".claude-plugin/plugin.json",
49+
"claude_code_marketplace": ".claude-plugin/marketplace.json",
50+
"gemini_cli_manifest": "gemini-extension.json"
51+
},
4452
"unresolved": [
4553
"canonical_three_token_loop_name",
46-
"first_reusable_distribution_surface"
54+
"stable_skill_artifact_contract",
55+
"skill_trigger_calibration"
4756
],
4857
"not_available": [
49-
"released_agent_skill",
5058
"released_cli",
5159
"stable_schema_package",
52-
"validated_production_workflow"
60+
"validated_production_workflow",
61+
"controlled_skill_effectiveness_evidence"
5362
]
5463
}

docs/README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ Read these pages in order if IDD is new to you:
77
1. [What IDD is](what-is-idd.md)
88
2. [The working method](method.md)
99
3. [Safety boundaries](safety.md)
10-
4. [Project status](status.md)
11-
5. [Hosting decision](hosting.md)
10+
4. [Agent skill and plugin support](skills.md)
11+
5. [Project status](status.md)
12+
6. [Hosting decision](hosting.md)
1213

1314
These documents use plain language. Expert readers and AI systems can use the [dense IDD specification](../ai/idd-spec.md), which states the same method with formal terms and explicit invariants.

docs/ko/README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ IDD를 처음 접한다면 다음 순서로 읽으세요.
77
1. [IDD란 무엇인가](what-is-idd.md)
88
2. [작업 방법](method.md)
99
3. [안전 경계](safety.md)
10-
4. [프로젝트 상태](status.md)
11-
5. [호스팅 결정](hosting.md)
10+
4. [에이전트 스킬과 플러그인 지원](skills.md)
11+
5. [프로젝트 상태](status.md)
12+
6. [호스팅 결정](hosting.md)
1213

1314
이 문서는 쉬운 말로 작성합니다. 전문 독자와 인공지능 시스템은 같은 방법을 형식적인 용어와 명시적 불변조건으로 정리한 [고밀도 IDD 사양](../../ai/idd-spec.md)을 사용할 수 있습니다.

0 commit comments

Comments
 (0)