Merge pull request #149 from wakqasahmed/fix/issue-96-rule9-wording

rules: reword rule 9 to presentation-only ranking (#96) & bump skill version

Author: ayghri

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i-have-adhd",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shape Claude Code output for an ADHD reader: lead with the next action, number steps, suppress tangents, restate state, make wins visible.",
   "author": {
     "name": "Ayoub G.",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i-have-adhd",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "ADHD-friendly output shaping for Codex: action first, numbered steps, no tangents, and visible progress.",
   "author": {
     "name": "Ayoub G.",

.cursor/skills/i-have-adhd/SKILL.md

@@ -100,9 +100,11 @@ Never use "Uh oh," "Oh no," or "There seems to be a problem." State cause and fi
 Bad: "Uh oh, the test is failing. There seems to be an issue..."
 Good: "Test fails at `auth.spec.ts:42`: expected 200, got 401. Cause: missing auth header. Fix: add `Authorization: Bearer ${token}` to the request."
 
-### 9. Cap lists at 5 items
+### 9. Rank and group long lists
 
-If a list grows past five, split into "do now" vs "later," or "must" vs "nice to have." Five items ranked beats ten unranked.
+For long lists in the final response, group related items and rank the most relevant first. Keep the visible working set small: aim for no more than five items per group. When more items are relevant, show additional groups instead of omitting them.
+
+Never omit relevant items when completeness matters. This rule shapes presentation only; it must not limit analysis, search, tool results, candidate generation, or retained information.
 
 ### 10. No preamble, no recap, no closing pleasantries
 

.github/install/INSTALL.ja.md

@@ -47,7 +47,7 @@ agy plugin uninstall i-have-adhd
 6. 所要時間は「少し」などの曖昧な表現を使わず、分単位などの具体的な数値で示す。
 7. 変更後は、何が動作するようになったかを目に見える形で示す。
 8. エラーは場所・原因・修正方法を淡々と伝える（大げさな表現は避ける）。
-9. リストは最大5項目までに抑える。
+9. 長いリストは重要度順に並べ、1グループ5項目以内を目安に分ける。必要な項目は省略しない。
 10. 前置き、要約、締めの挨拶は入れない。
 
 例外規定：解説を求められた場合は十分に説明する。破壊的な操作を行う前には必ず確認を取る。修正に3回失敗した場合は一度停止し、前提条件のどこに誤りがあるかを指摘する。指示が曖昧な場合は短い質問を1つだけ行う。
@@ -163,7 +163,7 @@ codex plugin marketplace remove i-have-adhd
 6. 所要時間は「少し」などの曖昧な表現を使わず、分単位などの具体的な数値で示す。
 7. 変更後は、何が動作するようになったかを目に見える形で示す。
 8. エラーは場所・原因・修正方法を淡々と伝える（大げさな表現は避ける）。
-9. リストは最大5項目までに抑える。
+9. 長いリストは重要度順に並べ、1グループ5項目以内を目安に分ける。必要な項目は省略しない。
 10. 前置き、要約、締めの挨拶は入れない。
 
 例外規定：解説を求められた場合は十分に説明する。破壊的な操作を行う前には必ず確認を取る。修正に3回失敗した場合は一度停止し、前提条件のどこに誤りがあるかを指摘する。指示が曖昧な場合は短い質問を1つだけ行う。
@@ -285,7 +285,7 @@ Copilot は設定項目の `disable-model-invocation` に従います。Claude C
 6. 所要時間は「少し」などの曖昧な表現を使わず、分単位などの具体的な数値で示す。
 7. 変更後は、何が動作するようになったかを目に見える形で示す。
 8. エラーは場所・原因・修正方法を淡々と伝える（大げさな表現は避ける）。
-9. リストは最大5項目までに抑える。
+9. 長いリストは重要度順に並べ、1グループ5項目以内を目安に分ける。必要な項目は省略しない。
 10. 前置き、要約、締めの挨拶は入れない。
 
 例外規定：解説を求められた場合は十分に説明する。破壊的な操作を行う前には必ず確認を取る。修正に3回失敗した場合は一度停止し、前提条件のどこに誤りがあるかを指摘する。指示が曖昧な場合は短い質問を1つだけ行う。
@@ -349,7 +349,7 @@ tap も削除する場合：`hermes skills tap remove ayghri/i-have-adhd`
 6. 所要時間は「少し」などの曖昧な表現を使わず、分単位などの具体的な数値で示す。
 7. 変更後は、何が動作するようになったかを目に見える形で示す。
 8. エラーは場所・原因・修正方法を淡々と伝える（大げさな表現は避ける）。
-9. リストは最大5項目までに抑える。
+9. 長いリストは重要度順に並べ、1グループ5項目以内を目安に分ける。必要な項目は省略しない。
 10. 前置き、要約、締めの挨拶は入れない。
 
 例外規定：解説を求められた場合は十分に説明する。破壊的な操作を行う前には必ず確認を取る。修正に3回失敗した場合は一度停止し、前提条件のどこに誤りがあるかを指摘する。指示が曖昧な場合は短い質問を1つだけ行う。
@@ -658,7 +658,7 @@ Skills マネージャーから `i-have-adhd` を削除するか、`~/.config/ze
 6. 所要時間は「少し」などの曖昧な表現を使わず、分単位などの具体的な数値で示す。
 7. 変更後は、何が動作するようになったかを目に見える形で示す。
 8. エラーは場所・原因・修正方法を淡々と伝える（大げさな表現は避ける）。
-9. リストは最大5項目までに抑える。
+9. 長いリストは重要度順に並べ、1グループ5項目以内を目安に分ける。必要な項目は省略しない。
 10. 前置き、要約、締めの挨拶は入れない。
 
 例外規定：解説を求められた場合は十分に説明する。破壊的な操作を行う前には必ず確認を取る。修正に3回失敗した場合は一度停止し、前提条件のどこに誤りがあるかを指摘する。指示が曖昧な場合は短い質問を1つだけ行う。
@@ -732,7 +732,7 @@ OpenCode の場合：`~/.config/opencode/AGENTS.md`。
 6. 所要時間は「少し」などの曖昧な表現を使わず、分単位などの具体的な数値で示す。
 7. 変更後は、何が動作するようになったかを目に見える形で示す。
 8. エラーは場所・原因・修正方法を淡々と伝える（大げさな表現は避ける）。
-9. リストは最大5項目までに抑える。
+9. 長いリストは重要度順に並べ、1グループ5項目以内を目安に分ける。必要な項目は省略しない。
 10. 前置き、要約、締めの挨拶は入れない。
 
 例外規定：解説を求められた場合は十分に説明する。破壊的な操作を行う前には必ず確認を取る。修正に3回失敗した場合は一度停止し、前提条件のどこに誤りがあるかを指摘する。指示が曖昧な場合は短い質問を1つだけ行う。

.github/install/INSTALL.ko.md

@@ -47,7 +47,7 @@ agy plugin uninstall i-have-adhd
 6. 시간은 구체적인 단위로 예상하고 "조금"이라고 하지 마세요.
 7. 변경 후에는 이제 무엇이 작동하는지 보여 주세요.
 8. 오류는 위치, 원인, 해결 방법을 담담하게 알려 주세요.
-9. 목록은 최대 5개 항목으로 제한하세요.
+9. 긴 목록은 중요도순으로 정렬하고 그룹당 최대 5개 항목을 목표로 나누되, 관련 항목은 생략하지 마세요.
 10. 서론, 요약, 마무리 인사를 넣지 마세요.
 
 예외: 설명을 요청받으면 충분히 설명하세요. 파괴적인 작업 전에는 확인하세요. 세 번의 수정이 실패하면 멈추고 의심되는 가정을 밝히세요. 요청이 모호하면 짧은 질문 하나를 하세요.
@@ -163,7 +163,7 @@ codex plugin marketplace remove i-have-adhd
 6. 시간은 구체적인 단위로 예상하고 "조금"이라고 하지 마세요.
 7. 변경 후에는 이제 무엇이 작동하는지 보여 주세요.
 8. 오류는 위치, 원인, 해결 방법을 담담하게 알려 주세요.
-9. 목록은 최대 5개 항목으로 제한하세요.
+9. 긴 목록은 중요도순으로 정렬하고 그룹당 최대 5개 항목을 목표로 나누되, 관련 항목은 생략하지 마세요.
 10. 서론, 요약, 마무리 인사를 넣지 마세요.
 
 예외: 설명을 요청받으면 충분히 설명하세요. 파괴적인 작업 전에는 확인하세요. 세 번의 수정이 실패하면 멈추고 의심되는 가정을 밝히세요. 요청이 모호하면 짧은 질문 하나를 하세요.
@@ -285,7 +285,7 @@ Copilot은 `disable-model-invocation`을 따릅니다. Claude Code와 마찬가
 6. 시간은 구체적인 단위로 예상하고 "조금"이라고 하지 마세요.
 7. 변경 후에는 이제 무엇이 작동하는지 보여 주세요.
 8. 오류는 위치, 원인, 해결 방법을 담담하게 알려 주세요.
-9. 목록은 최대 5개 항목으로 제한하세요.
+9. 긴 목록은 중요도순으로 정렬하고 그룹당 최대 5개 항목을 목표로 나누되, 관련 항목은 생략하지 마세요.
 10. 서론, 요약, 마무리 인사를 넣지 마세요.
 
 예외: 설명을 요청받으면 충분히 설명하세요. 파괴적인 작업 전에는 확인하세요. 세 번의 수정이 실패하면 멈추고 의심되는 가정을 밝히세요. 요청이 모호하면 짧은 질문 하나를 하세요.
@@ -349,7 +349,7 @@ tap도 제거하려면 `hermes skills tap remove ayghri/i-have-adhd`를 실행
 6. 시간은 구체적인 단위로 예상하고 "조금"이라고 하지 마세요.
 7. 변경 후에는 이제 무엇이 작동하는지 보여 주세요.
 8. 오류는 위치, 원인, 해결 방법을 담담하게 알려 주세요.
-9. 목록은 최대 5개 항목으로 제한하세요.
+9. 긴 목록은 중요도순으로 정렬하고 그룹당 최대 5개 항목을 목표로 나누되, 관련 항목은 생략하지 마세요.
 10. 서론, 요약, 마무리 인사를 넣지 마세요.
 
 예외: 설명을 요청받으면 충분히 설명하세요. 파괴적인 작업 전에는 확인하세요. 세 번의 수정이 실패하면 멈추고 의심되는 가정을 밝히세요. 요청이 모호하면 짧은 질문 하나를 하세요.
@@ -450,7 +450,7 @@ npx skills remove i-have-adhd
 6. 시간은 구체적인 단위로 예상하고 "조금"이라고 하지 마세요.
 7. 변경 후에는 이제 무엇이 작동하는지 보여 주세요.
 8. 오류는 위치, 원인, 해결 방법을 담담하게 알려 주세요.
-9. 목록은 최대 5개 항목으로 제한하세요.
+9. 긴 목록은 중요도순으로 정렬하고 그룹당 최대 5개 항목을 목표로 나누되, 관련 항목은 생략하지 마세요.
 10. 서론, 요약, 마무리 인사를 넣지 마세요.
 
 예외: 설명을 요청받으면 충분히 설명하세요. 파괴적인 작업 전에는 확인하세요. 세 번의 수정이 실패하면 멈추고 의심되는 가정을 밝히세요. 요청이 모호하면 짧은 질문 하나를 하세요.
@@ -551,7 +551,7 @@ Skills 관리자에서 `i-have-adhd`를 제거하거나 `~/.config/zed/skills/i-
 6. 시간은 구체적인 단위로 예상하고 "조금"이라고 하지 마세요.
 7. 변경 후에는 이제 무엇이 작동하는지 보여 주세요.
 8. 오류는 위치, 원인, 해결 방법을 담담하게 알려 주세요.
-9. 목록은 최대 5개 항목으로 제한하세요.
+9. 긴 목록은 중요도순으로 정렬하고 그룹당 최대 5개 항목을 목표로 나누되, 관련 항목은 생략하지 마세요.
 10. 서론, 요약, 마무리 인사를 넣지 마세요.
 
 예외: 설명을 요청받으면 충분히 설명하세요. 파괴적인 작업 전에는 확인하세요. 세 번의 수정이 실패하면 멈추고 의심되는 가정을 밝히세요. 요청이 모호하면 짧은 질문 하나를 하세요.
@@ -621,7 +621,7 @@ npx skills remove i-have-adhd -g    # 전역 설치한 경우
 6. 시간은 구체적인 단위로 예상하고 "조금"이라고 하지 마세요.
 7. 변경 후에는 이제 무엇이 작동하는지 보여 주세요.
 8. 오류는 위치, 원인, 해결 방법을 담담하게 알려 주세요.
-9. 목록은 최대 5개 항목으로 제한하세요.
+9. 긴 목록은 중요도순으로 정렬하고 그룹당 최대 5개 항목을 목표로 나누되, 관련 항목은 생략하지 마세요.
 10. 서론, 요약, 마무리 인사를 넣지 마세요.
 
 예외: 설명을 요청받으면 충분히 설명하세요. 파괴적인 작업 전에는 확인하세요. 세 번의 수정이 실패하면 멈추고 의심되는 가정을 밝히세요. 요청이 모호하면 짧은 질문 하나를 하세요.

.github/install/INSTALL.pt-BR.md

@@ -47,7 +47,7 @@ A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:
 6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
 7. Após uma alteração, mostre o que agora funciona.
 8. Erros: informe local, causa e correção, sem drama.
-9. Limite listas a 5 itens.
+9. Ordene listas longas por relevância e procure usar no máximo cinco itens por grupo, sem omitir itens relevantes.
 10. Sem preâmbulo, recapitulação ou despedida.
 
 Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
@@ -163,7 +163,7 @@ A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:
 6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
 7. Após uma alteração, mostre o que agora funciona.
 8. Erros: informe local, causa e correção, sem drama.
-9. Limite listas a 5 itens.
+9. Ordene listas longas por relevância e procure usar no máximo cinco itens por grupo, sem omitir itens relevantes.
 10. Sem preâmbulo, recapitulação ou despedida.
 
 Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
@@ -285,7 +285,7 @@ A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:
 6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
 7. Após uma alteração, mostre o que agora funciona.
 8. Erros: informe local, causa e correção, sem drama.
-9. Limite listas a 5 itens.
+9. Ordene listas longas por relevância e procure usar no máximo cinco itens por grupo, sem omitir itens relevantes.
 10. Sem preâmbulo, recapitulação ou despedida.
 
 Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
@@ -349,7 +349,7 @@ A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:
 6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
 7. Após uma alteração, mostre o que agora funciona.
 8. Erros: informe local, causa e correção, sem drama.
-9. Limite listas a 5 itens.
+9. Ordene listas longas por relevância e procure usar no máximo cinco itens por grupo, sem omitir itens relevantes.
 10. Sem preâmbulo, recapitulação ou despedida.
 
 Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
@@ -450,7 +450,7 @@ A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:
 6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
 7. Após uma alteração, mostre o que agora funciona.
 8. Erros: informe local, causa e correção, sem drama.
-9. Limite listas a 5 itens.
+9. Ordene listas longas por relevância e procure usar no máximo cinco itens por grupo, sem omitir itens relevantes.
 10. Sem preâmbulo, recapitulação ou despedida.
 
 Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
@@ -551,7 +551,7 @@ A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:
 6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
 7. Após uma alteração, mostre o que agora funciona.
 8. Erros: informe local, causa e correção, sem drama.
-9. Limite listas a 5 itens.
+9. Ordene listas longas por relevância e procure usar no máximo cinco itens por grupo, sem omitir itens relevantes.
 10. Sem preâmbulo, recapitulação ou despedida.
 
 Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
@@ -621,7 +621,7 @@ A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:
 6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
 7. Após uma alteração, mostre o que agora funciona.
 8. Erros: informe local, causa e correção, sem drama.
-9. Limite listas a 5 itens.
+9. Ordene listas longas por relevância e procure usar no máximo cinco itens por grupo, sem omitir itens relevantes.
 10. Sem preâmbulo, recapitulação ou despedida.
 
 Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.