docs(agents): document advisory frontmatter fields and remove stale temperature#740
Merged
Merged
Conversation
…emperature Document in CUSTOM_EXTENSIONS.md that applies_to/keywords are advisory inputs to the fleet-orchestrator Top-K routing score (not official runtime path-triggers), and that structure-explorer's memory:local with no initialPrompt is intentional. Remove the stale temperature: 0.3 line from the README.md and README.ko.md Agent Configuration examples (the field was already dropped from all agents in #662).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
변경 내용
에이전트 fleet의 문서 정합을 위한 P2/P3 문서 항목 3가지를 처리했다.
docs/CUSTOM_EXTENSIONS.md에applies_to/keywords가 공식 런타임 path-trigger가 아니라fleet-orchestrator의 Top-K routing 입력임을 명문화.docs/CUSTOM_EXTENSIONS.md에structure-explorer의memory: local+initialPrompt미선언이 의도된 설계임을 명문화.README.md/README.ko.md의 Agent Configuration 예시 YAML에서 staletemperature: 0.3제거.배경
applies_to/keywords는 path-trigger처럼 보이지만 공식 런타임은 오직description으로만 위임한다. 이 두 필드는fleet-orchestrator스킬의 Top-K routing 점수식(score = 2 * matched_applies_to_globs + 1 * matched_keywords,global/skills/_internal/fleet-orchestrator/SKILL.md)이 소비하는 advisory 입력이다. 문서가 없으면 유지보수자가 "특정 파일을 열면 에이전트가 자동 호출된다"고 오해할 수 있다. → 제거가 아니라 용도 문서화가 정답.structure-explorer는 8개 중 유일하게memory: project+ 부트스트랩initialPrompt패턴에서 벗어난다. stateless 1-shot 탐색 성격상 의도된 것이나, 문서가 없으면 "실수로 빠진 것"으로 오인된다.temperature: 0.3을 여전히 노출해, 신규 작성자가 복제할 위험이 있었다.검증
grep temperature README.md README.ko.md→ 각 0건docs/CUSTOM_EXTENSIONS.md에 advisory 필드·structure-explorer 노트 삽입 확인(CI enforcement 단락 뒤, Skill reference 단락 앞)Closes #737
Part of #726