Archon

Category: Tools & Productivity | Uploader: Schr0d | Downloads: 0 | Version: v1.0（Latest）

Archon can be invoked as a skill by AI agents during the development loop to provide architectural context and validation.

Changelog: Source: GitHub https://github.com/Schr0d/Archon

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 build.yml 1.1 KB
  - 📄 release.yml 1.0 KB
📁 .superpowers/
- 📁 brainstorm/
  - 📁 9903-1775475572/
    
    📁 content/
    
    📄 a11y-priority.html 1.2 KB
    
    📄 design-sketch.html 13.8 KB
    
    📄 empty-state.html 1.2 KB
    
    📄 intro-text.html 1.2 KB
    
    📄 sidebar-layout.html 1.3 KB
    
    📁 state/
    
    📄 server-stopped 52 B
    
    📄 server.pid 5 B
  - 📁 9942-1775475806/
    
    📁 state/
    
    📄 server.pid 5 B
- 📄 viz-issues.md 1.3 KB
📁 archon-cli/
- 📁 src/
  - 📁 main/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 cli/
    
    📄 AnalyzeCommand.java 16.6 KB
    
    📄 ArchonCli.java 769 B
    
    📄 CheckCommand.java 4.8 KB
    
    📄 DiffCommand.java 21.3 KB
    
    📄 EcpCommand.java 723 B
    
    📄 ImpactCommand.java 6.9 KB
  - 📁 test/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 cli/
    
    📄 AnalyzeCommandTest.java 3.8 KB
    
    📄 DiffCommandTest.java 1.9 KB
    
    📄 ImpactCommandTest.java 6.6 KB
- 📄 build.gradle.kts 964 B
📁 archon-core/
- 📁 src/
  - 📁 main/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 core/
    
    📁 analysis/
    
    📄 AnalysisPipeline.java 8.8 KB
    
    📄 AnalysisResult.java 544 B
    
    📄 ArchLayer.java 676 B
    
    📄 CentralityCalculator.java 16.2 KB
    
    📄 CentralityService.java 1.1 KB
    
    📄 ChangeImpactReport.java 1.8 KB
    
    📄 CouplingAnalyzer.java 837 B
    
    📄 CycleDetector.java 2.2 KB
    
    📄 DomainDetector.java 2.9 KB
    
    📄 DomainResult.java 1.0 KB
    
    📄 DomainStrategy.java 927 B
    
    📄 FullAnalysisData.java 1.2 KB
    
    📄 GraphDiff.java 1.9 KB
    
    📄 GraphDiffer.java 4.4 KB
    
    📄 ImpactPropagator.java 3.7 KB
    
    📄 ImpactResult.java 2.1 KB
    
    📄 LayerClassifier.java 1.9 KB
    
    📄 RiskScorer.java 1.8 KB
    
    📄 RiskSummary.java 1.2 KB
    
    📄 RiskSynthesizer.java 4.8 KB
    
    📄 ThresholdCalculator.java 649 B
    
    📄 Thresholds.java 949 B
    
    📁 config/
    
    📄 ArchonConfig.java 3.7 KB
    
    📄 RuleValidator.java 5.6 KB
    
    📄 RuleViolation.java 786 B
    
    📁 coordination/
    
    📄 ParseOrchestrator.java 6.3 KB
    
    📁 ecp/
    
    📄 EcpGenerator.java 312 B
    
    📁 git/
    
    📄 CliGitAdapter.java 4.5 KB
    
    📄 GitAdapter.java 1.2 KB
    
    📄 GitException.java 312 B
    
    📁 graph/
    
    📄 BlindSpot.java 1.6 KB
    
    📄 Confidence.java 284 B
    
    📄 DependencyGraph.java 9.5 KB
    
    📄 Edge.java 2.7 KB
    
    📄 EdgeType.java 195 B
    
    📄 GraphBuilder.java 791 B
    
    📄 Node.java 3.2 KB
    
    📄 NodeType.java 167 B
    
    📄 RiskLevel.java 181 B
    
    📁 output/
    
    📄 JsonSerializer.java 5.0 KB
    
    📁 plugin/
    
    📄 BlindSpot.java 1005 B
    
    📄 LanguagePlugin.java 3.2 KB
    
    📄 ParseContext.java 778 B
    
    📄 ParseResult.java 1.5 KB
    
    📄 PluginDiscoverer.java 2.3 KB
    
    📁 viz/
    
    📄 AsciiRenderer.java 323 B
    
    📄 DotExporter.java 5.1 KB
    
    📄 TerminalCapabilities.java 223 B
  - 📁 test/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 core/
    
    📁 analysis/
    
    📄 AnalysisPipelineTest.java 1.4 KB
    
    📄 CentralityCalculatorTest.java 23.2 KB
    
    📄 CentralityServiceTest.java 6.0 KB
    
    📄 CouplingAnalyzerTest.java 3.6 KB
    
    📄 CycleDetectorTest.java 3.3 KB
    
    📄 DomainDetectorTest.java 6.0 KB
    
    📄 DomainStrategyTest.java 594 B
    
    📄 GraphDifferTest.java 10.2 KB
    
    📄 ImpactPropagatorTest.java 5.4 KB
    
    📄 LayerClassifierTest.java 5.4 KB
    
    📄 RiskScorerTest.java 3.1 KB
    
    📄 RiskSynthesizerTest.java 11.0 KB
    
    📄 ThresholdCalculatorTest.java 1.8 KB
    
    📁 config/
    
    📄 ArchonConfigTest.java 3.4 KB
    
    📄 RuleValidatorTest.java 5.3 KB
    
    📁 coordination/
    
    📄 ParseOrchestratorTest.java 9.0 KB
    
    📁 git/
    
    📄 CliGitAdapterTest.java 5.4 KB
    
    📁 graph/
    
    📄 DependencyGraphTest.java 3.0 KB
    
    📁 output/
    
    📄 JsonSerializerTest.java 10.1 KB
    
    📁 plugin/
    
    📄 BlindSpotTest.java 923 B
    
    📄 LanguagePluginTest.java 2.1 KB
    
    📄 ParseContextTest.java 878 B
    
    📄 ParseResultTest.java 1.6 KB
    
    📄 PluginDiscovererTest.java 5.5 KB
- 📄 build.gradle.kts 339 B
📁 archon-java/
- 📁 src/
  - 📁 main/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 java/
    
    📄 AstVisitor.java 6.9 KB
    
    📄 BlindSpotDetector.java 4.6 KB
    
    📄 ImportResolver.java 2.2 KB
    
    📄 JavaDomainStrategy.java 2.0 KB
    
    📄 JavaParserPlugin.java 13.0 KB
    
    📄 JavaPlugin.java 7.6 KB
    
    📄 ModuleDetector.java 5.8 KB
    
    📄 SymbolSolverAdapter.java 2.8 KB
    
    📁 resources/
    
    📁 META-INF/
    
    📁 services/
    
    📄 com.archon.core.plugin.LanguagePlugin 26 B
  - 📁 test/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 java/
    
    📄 AstVisitorTest.java 7.2 KB
    
    📄 BlindSpotDetectorTest.java 4.1 KB
    
    📄 ImportResolverTest.java 2.1 KB
    
    📄 JavaDomainStrategyTest.java 4.2 KB
    
    📄 JavaParserPluginTest.java 6.3 KB
    
    📄 JavaPluginTest.java 5.7 KB
    
    📄 ModuleDetectorTest.java 2.5 KB
    
    📄 SymbolSolverAdapterTest.java 1.5 KB
- 📄 build.gradle.kts 274 B
📁 archon-js/
- 📁 src/
  - 📁 main/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 js/
    
    📄 JsAstVisitor.java 6.3 KB
    
    📄 JsDomainStrategy.java 2.0 KB
    
    📄 JsPlugin.java 6.9 KB
    
    📄 ModulePathResolver.java 7.6 KB
    
    📄 VueFileExtractor.java 3.1 KB
    
    📁 resources/
    
    📁 META-INF/
    
    📁 services/
    
    📄 com.archon.core.plugin.LanguagePlugin 22 B
  - 📁 test/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 js/
    
    📄 ClosureCompilerValidationTest.java 13.0 KB
    
    📄 JsPluginTest.java 5.6 KB
    
    📄 ModulePathResolverTest.java 13.5 KB
- 📄 build.gradle.kts 480 B
📁 archon-python/
- 📁 src/
  - 📁 main/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 python/
    
    📄 PythonDomainStrategy.java 3.3 KB
    
    📄 PythonImportExtractor.java 3.7 KB
    
    📄 PythonModuleResolver.java 7.5 KB
    
    📄 PythonPlugin.java 8.2 KB
    
    📄 PythonStdlib.java 7.0 KB
    
    📁 resources/
    
    📁 META-INF/
    
    📁 services/
    
    📄 com.archon.core.plugin.LanguagePlugin 30 B
  - 📁 test/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 python/
    
    📄 PythonDomainStrategyTest.java 5.8 KB
    
    📄 PythonImportExtractorTest.java 3.8 KB
    
    📄 PythonModuleResolverTest.java 7.9 KB
    
    📄 PythonPluginTest.java 6.1 KB
    
    📄 PythonStdlibTest.java 3.2 KB
- 📄 build.gradle.kts 314 B
📁 archon-test/
- 📄 build.gradle.kts 129 B
📁 archon-viz/
- 📁 src/
  - 📁 main/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 viz/
    
    📄 DiffSerializer.java 8.3 KB
    
    📄 EdgeView.java 1.0 KB
    
    📄 JsonSerializer.java 21.3 KB
    
    📄 NodeGroup.java 625 B
    
    📄 NodeView.java 1.2 KB
    
    📄 PerspectiveBuilder.java 6.3 KB
    
    📄 PerspectiveView.java 1001 B
    
    📄 TerminalRenderer.java 2.8 KB
    
    📄 ViewCommand.java 6.4 KB
    
    📄 ViewServer.java 7.9 KB
    
    📁 resources/
    
    📁 lib/
    
    📄 dagre.min.js 277.2 KB
    
    📄 archon-viewer.html 42.3 KB
  - 📁 test/
    
    📁 java/
    
    📁 com/
    
    📁 archon/
    
    📁 viz/
    
    📄 DiffSerializerTest.java 20.0 KB
    
    📄 JsonSerializerTest.java 20.0 KB
    
    📄 PerspectiveBuilderTest.java 4.4 KB
    
    📄 TerminalRendererTest.java 3.6 KB
    
    📄 ViewCommandTest.java 19.0 KB
    
    📄 ViewServerTest.java 2.8 KB
- 📄 build.gradle.kts 737 B
📁 archon-viz-web/
- 📁 src/
  - 📄 arrowRouter.test.ts 7.9 KB
  - 📄 arrowRouter.ts 2.9 KB
  - 📄 dataManager.test.ts 3.1 KB
  - 📄 dataManager.ts 2.2 KB
  - 📄 detailPanel.ts 7.8 KB
  - 📄 forceSimulation.test.ts 4.1 KB
  - 📄 forceSimulation.ts 8.3 KB
  - 📄 graphController.ts 13.5 KB
  - 📄 impactAnalysis.test.ts 4.0 KB
  - 📄 impactAnalysis.ts 2.4 KB
  - 📄 mode1DomainView.ts 10.4 KB
  - 📄 mode2BoundaryView.ts 34.1 KB
- 📄 .gitignore 14 B
- 📄 build.gradle.kts 770 B
- 📄 index.html 42.3 KB
- 📄 package-lock.json 145.4 KB
- 📄 package.json 617 B
- 📄 vitest.config.ts 194 B
📁 docs/
- 📁 superpowers/
  - 📁 plans/
    
    📄 2025-04-08-json-first-output.md 24.8 KB
  - 📁 specs/
    
    📄 2025-04-08-archon-viz-redesign-design.md 13.9 KB
📁 gradle/
- 📁 wrapper/
  - 📄 gradle-wrapper.jar 42.6 KB
  - 📄 gradle-wrapper.properties 251 B
📄 .gitignore 313 B
📄 archon-context.json 56.1 KB
📄 archon-self.json 155.3 KB
📄 archon-self.mmd 13.2 KB
📄 archon-viz-design-preview.html 28.7 KB
📄 archon-viz-sketch.html 23.2 KB
📄 archon-viz-theme-sketch.html 29.1 KB
📄 build.gradle.kts 439 B
📄 CHANGELOG.md 6.6 KB
📄 DESIGN.md 14.2 KB
📄 gradle.properties 31 B
📄 gradlew 4.8 KB
📄 gradlew.bat 2.8 KB
📄 LICENSE 1.0 KB
📄 post-agent-integration.md 1.9 KB
📄 README-zh.md 6.9 KB
📄 README.md 10.4 KB
📄 settings.gradle.kts 214 B
📄 skill.md 3.5 KB
📄 TODOS.md 12.0 KB
📄 VERSION 8 B

SKILL.md

# Archon AI Skill

## Overview

Archon can be invoked as a skill by AI agents during the development loop to provide architectural context and validation.

---

## When to Use

Invoke this skill **before** making code changes and **after** making changes:

### Before Changes (Plan Phase)
- When planning a refactoring
- When modifying high-risk modules
- When crossing domain boundaries
- When evaluating impact surfaces

### After Changes (Review Phase)
- Before committing code
- Before creating a PR
- When validating architectural integrity
- When checking for introduced violations

---

## Skill Invocation

### Analyze Repository

```bash
java -jar archon.jar analyze <path> [--json] [--verbose]
```

**Returns:** Domain boundaries, hotspots, cycles, blind spots

**Use for:** Understanding architectural context before planning changes

---

### Impact Analysis

```bash
java -jar archon.jar impact <module> <path> [--depth N]
```

**Returns:** Affected nodes, cross-domain edges, risk levels

**Use for:** Evaluating blast radius before modifying specific modules

---

### Diff Validation

```bash
java -jar archon.jar diff <base> <head> <path> [--ci]
```

**Returns:** Added/removed edges, violations, gate status (PASS/BLOCKED)

**Use for:** Pre-commit validation, PR review gate

---

### Rule Checking

```bash
java -jar archon.jar check <path> [--ci]
```

**Returns:** Rule violations, architectural constraints

**Use for:** CI/CD integration, automated quality gates

---

## AI Agent Integration Pattern

### 1. Plan Phase

```python
# Agent: Get architectural context
context = archon.analyze(path, format="json")

# Check if target is safe to modify
if target_module in context["hotspots"]:
    return f"WARNING: {target_module} is HIGH-RISK hotspot"

# Plan within architectural constraints
plan = generate_plan(context["domains"], context["boundaries"])
```

### 2. Execute Phase

```python
# Agent: Make changes respecting constraints
for change in plan:
    if crosses_domain_boundary(change, context):
        review_change_architecture(change)
    apply_change(change)
```

### 3. Review Phase

```python
# Agent: Validate before committing
review = archon.diff(base="HEAD~1", head="HEAD", path=".", ci=True)

if review["gate"] == "BLOCKED":
    handle_violations(review["violations"])
    return "Fix required before commit"

return "Changes validated, safe to commit"
```

---

## Expected Output Format

### Analyze (JSON)

```json
{
  "domains": [
    {"name": "core", "nodes": 45, "boundaries": ["com.archon.core.*"]}
  ],
  "hotspots": [
    {"node": "com.archon.core.graph.DependencyGraph", "inDegree": 18, "risk": "HIGH"}
  ],
  "cycles": [],
  "blindSpots": [
    {"type": "CommonJS", "count": 624, "file": "dagre.min"}
  ]
}
```

### Diff (CI Mode)

```
=== Structural Impact Review ===
Violations: 1
  ✗ max_cross_domain exceeded (current: 4, limit: 3)
Gate: BLOCKED
```

---

## Best Practices for AI Agents

1. **Always analyze before planning** — Get architectural context first
2. **Check hotspots before modifying** — High-risk nodes require extra caution
3. **Validate after changes** — Use diff as a review gate
4. **Respect domain boundaries** — Cross-domain changes need architectural review
5. **Declare uncertainty** — Blind spots should be flagged, not ignored

---

## Exit Codes

- `0` — Success, no violations
- `1` — Violations found (in CI mode)
- `2` — Analysis error

---

## See Also

- [README.md](README.md) — Full documentation
- [TODOS.md](TODOS.md) — Deferred work

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

Archon

Directory Structure

SKILL.md

Report

Notice