Junieのナレッジベース
JunieはJetBrains IDE、interactive CLI、headless CI、GitHub Actions、GitLab pipelinesで動作します。Project trust、guidelines、Skills、MCP、approval modes、sandbox policy、review agentsによりrunの条件が変わります。Durable knowledgeはexecution surfaceから記録します。
Execution surfaces
IDE、CLI、CI runは同一のtrust/approval modelを継承しない。
JunieはJetBrains IDE、interactive terminal、headless pipelineで動きます。Surface、authentication、checkout、model/provider、人が介入できたかを記録します。
| Surface | Human interaction | Primary evidence |
|---|---|---|
| JetBrains IDE | Interactive | IDE actions、inspections、diff |
| Junie CLI | Interactive / headless | Session events、commands、files |
| GitHub Action | Pipeline-triggered | PR、checks、action logs |
| GitLab CI/CD | Issue/MR-triggered | Pipeline、MR、artifacts |
Project trust
RepositoryがwritableでもJunie configはuntrustedのままにできる。
Interactive CLIはproject config、MCP、hooks、agents、commands、Skills、guidelines、memoryをloadする前にtrustを確認します。Untrusted projectはtemporary storageを使います。Non-interactive/ACPはprompt不可のためtrusted扱いなのでpipeline governanceが必要です。
Symlink/scopeを解決
Exact project / parent scope
Trusted sourcesのみ
Surface controls適用
Ownerがshared stateをaccept
Guidelinesとmemory
AGENTS.mdはpersistent guidance、memoryはcurationが必要なcontext。
`.junie/AGENTS.md`、root AGENTS.md + playbook/rules、legacy guidelinesの順序とproject/global guidanceを記録します。Instructionはversioned、changing decisionはreviewed recordへ移します。
Repository conventions / commands
Personal / organization preferences
Later session用に抽出したcontext
Owner/freshness付きaccepted state
Agent Skills
Portable Skillsはprocedure/support filesを持ち、current approval stateは持たない。
Project、user、`.agents`、extension、custom locationsからloadされ、自動またはslash commandで実行されます。Bundled scriptsを含むthird-party Skillはrevisionをpinし内容をreviewします。
Procedure、templates、scripts、checklist
Accepted outcome、owner、lifecycle
Approval stack
Action Allowlist、Brave mode、sandboxは異なるfriction/blast radiusを制御する。
Allowlistはpromptを省略し、Brave modeはask頻度を変え、sandboxはterminal commandsだけをwrapします。File edits、MCP、hooks、Junie-managed Git operationsは対象外です。
| Control | Changes | Does not prove |
|---|---|---|
| Action Allowlist | Matched action prompt | Result correctness |
| Brave mode | Ask / auto / broad execution | Credential appropriateness |
| Sandbox | Terminal filesystem/network risk | All Junie actions isolated |
| Change Request | Shared record acceptance | Execution repeatability |
MCP scopes
Project/user MCP configはsharingとsecret riskが異なる。
Projectは`.junie/mcp/mcp.json`、userは`~/.junie/mcp/mcp.json`です。Local/remote、OAuth、runtime statusを保持します。ACP clientsはlist可能ですがinstallation assistantでconfig editしません。
Shareable config、secretをcommitしない
Private machine-wide config
Client-supplied/local runtime list
Execution後のevidence-backed state
Review evidence
Code review agentはread-only analysisでありsuggestion acceptanceは別action。
Diff/project contextを読みますがfile edit、build/test、commit/pushはしません。Target、finding、accept/dismiss、patch、tests、final revisionを保存します。
Knowledge contract
結果を実行時のJunie環境と制御状態へ結び付ける。
Compact recordにreproduce/challenge可能なprovenanceを保持します。
outcome_keyStable identityexecution_surfaceIDE、CLI、GitHub、GitLabsession_or_runSession、pipeline、action reftrust_configProject trust / config digestguidance_refsAGENTS.md、Skills、memoryaction_evidenceCommands、MCP calls、diffs、logsverificationReview、tests、readbackowner_decisionAcceptance / freshness実務上の質問
JunieナレッジベースのFAQ
BusabaseはJunie guidelinesを置換しますか?
いいえ。Guidelinesはbehavior、Busabaseはselected reviewed outcomesです。
Untrusted projectはunreadableですか?
いいえ。Workspace filesは利用でき、project-provided configだけloadされません。
SandboxはMCP/file editsをcoverしますか?
いいえ。Current docsではterminal commandsのみです。
Action AllowlistはMCP resultをapproveしますか?
いいえ。Confirmation promptとresult reviewは別です。
Code review findingを直接recordにできますか?
Findingはevidenceであり、accepted patch、verification、owner、final revisionが必要です。
1つのverified Junie runから始める
Surface、trust decision、controls、final repository evidenceを記録する。
Stable outcomeに到達したIDE、CLI、CI taskを選び、execution boundaryを保存し、reusable resultだけreviewへ送ります。

