Skip to content

Commit b594923

Browse files
montfortclaude
montfort
and
claude
committed
Initialize arborist-cli project with DevTrail and project idea
Set up the CLI companion project for arborist-metrics with: - DevTrail fw-4.1.0 governance framework - IDEA.md capturing project vision, scope, and capabilities based on the arborist-metrics 0.1.x API surface Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
0 parents  commit b594923

105 files changed

Lines changed: 16302 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.agent/workflows/devtrail-adr.md‎

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
---
2+
description: Create an ADR (Architecture Decision Record) for significant architectural decisions. Requires human review.
3+
---
4+
5+
# DevTrail ADR Skill
6+
7+
Create an Architecture Decision Record (ADR) for significant architectural decisions.
8+
9+
> **Note**: ADRs created by AI agents are marked as `draft` and `review_required: true` by default.
10+
11+
## Instructions
12+
13+
Use this skill for major architectural decisions that affect the system structure, technology stack, or design patterns.
14+
15+
### 1. Gather Context
16+
17+
```bash
18+
# Get current date
19+
date +%Y-%m-%d
20+
21+
# Get recent changes for context
22+
git diff --stat HEAD~1 2>/dev/null || git diff --stat
23+
24+
# Check for related ADRs
25+
ls .devtrail/02-design/decisions/ADR-*.md 2>/dev/null | tail -5
26+
```
27+
28+
### 2. Confirm with User
29+
30+
**Always confirm before creating:**
31+
32+
```
33+
╔══════════════════════════════════════════════════════════════════╗
34+
║ DevTrail ADR ║
35+
╠══════════════════════════════════════════════════════════════════╣
36+
║ ║
37+
║ ⚠️ ADRs require human review after creation. ║
38+
║ ║
39+
║ 📋 An ADR documents architectural decisions that affect: ║
40+
║ • System structure ║
41+
║ • Technology choices ║
42+
║ • Design patterns ║
43+
║ • Integration approaches ║
44+
║ ║
45+
║ Please provide: ║
46+
║ 1. Decision title (what architectural decision) ║
47+
║ 2. Context (why is this decision needed) ║
48+
║ 3. The decision and alternatives considered ║
49+
║ ║
50+
╚══════════════════════════════════════════════════════════════════╝
51+
```
52+
53+
### 3. Determine Sequence Number
54+
55+
```bash
56+
# Count existing ADRs for today
57+
ls .devtrail/02-design/decisions/ADR-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l
58+
```
59+
60+
### 4. Check Language and Load Template
61+
62+
Read `.devtrail/config.yml` for language setting:
63+
- `en` (default): `.devtrail/templates/TEMPLATE-ADR.md`
64+
- `es`: `.devtrail/templates/i18n/es/TEMPLATE-ADR.md`
65+
66+
### 5. Create Document
67+
68+
Fill template with:
69+
- `id`: ADR-YYYY-MM-DD-NNN
70+
- `title`: Architectural decision title
71+
- `status`: **draft** (always for AI-created ADRs)
72+
- `created`: Current date
73+
- `updated`: Current date
74+
- `agent`: your agent identifier (e.g., `cursor-v1.0`, `copilot-v1.0`, `windsurf-v1.0`)
75+
- `confidence`: based on research done
76+
- `review_required`: **true** (always for ADRs)
77+
- `risk_level`: minimum `medium` for architectural decisions
78+
79+
**Key sections to fill:**
80+
- Status: Note that this was created by AI agent
81+
- Context: Technical and business context, forces at play
82+
- Decision: The architectural decision with justification
83+
- Alternatives Considered: Other options with pros/cons/why not
84+
- Consequences: Positive, negative, neutral
85+
- Affected Components: Table of impacted parts
86+
- Implementation Plan: High-level steps
87+
- Success Metrics: How to validate the decision
88+
89+
Save to: `.devtrail/02-design/decisions/ADR-YYYY-MM-DD-NNN-description.md`
90+
91+
### 6. Report Result
92+
93+
```
94+
⚠️ ADR created (requires human review):
95+
.devtrail/02-design/decisions/ADR-YYYY-MM-DD-NNN-description.md
96+
97+
Status: draft
98+
Review Required: YES
99+
100+
DevTrail: Created ADR-YYYY-MM-DD-NNN-description.md (review required)
101+
```
102+
103+
## Examples of Architectural Decisions
104+
105+
- Use PostgreSQL over MongoDB for persistence
106+
- Adopt microservices vs. monolith architecture
107+
- Choose REST vs. GraphQL for API
108+
- Select authentication strategy (JWT, OAuth, etc.)
109+
- Define module boundaries and dependencies
110+
- Establish caching strategy

‎.agent/workflows/devtrail-aidec.md‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
description: Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.
3+
---
4+
5+
# DevTrail AIDEC Skill
6+
7+
Create an AI Decision (AIDEC) document to record technical decisions and the alternatives considered.
8+
9+
## Instructions
10+
11+
Use this skill when you've made a decision between multiple technical approaches and want to document the reasoning.
12+
13+
### 1. Gather Context
14+
15+
```bash
16+
# Get current date
17+
date +%Y-%m-%d
18+
19+
# Get recent changes for context
20+
git diff --stat HEAD~1 2>/dev/null || git diff --stat
21+
```
22+
23+
### 2. Confirm with User
24+
25+
**Always confirm before creating:**
26+
27+
```
28+
╔══════════════════════════════════════════════════════════════════╗
29+
║ DevTrail AIDEC ║
30+
╠══════════════════════════════════════════════════════════════════╣
31+
║ ║
32+
║ 📋 AIDEC documents a decision between alternatives. ║
33+
║ ║
34+
║ Please provide: ║
35+
║ 1. Decision title (what was decided) ║
36+
║ 2. Alternatives considered (2-3 options) ║
37+
║ 3. Which alternative was chosen and why ║
38+
║ ║
39+
╚══════════════════════════════════════════════════════════════════╝
40+
```
41+
42+
### 3. Determine Sequence Number
43+
44+
```bash
45+
# Count existing AIDECs for today
46+
ls .devtrail/07-ai-audit/decisions/AIDEC-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l
47+
```
48+
49+
### 4. Check Language and Load Template
50+
51+
Read `.devtrail/config.yml` for language setting:
52+
- `en` (default): `.devtrail/templates/TEMPLATE-AIDEC.md`
53+
- `es`: `.devtrail/templates/i18n/es/TEMPLATE-AIDEC.md`
54+
55+
### 5. Create Document
56+
57+
Fill template with:
58+
- `id`: AIDEC-YYYY-MM-DD-NNN
59+
- `title`: Decision title from user
60+
- `created`: Current date
61+
- `agent`: your agent identifier (e.g., `cursor-v1.0`, `copilot-v1.0`, `windsurf-v1.0`)
62+
- `confidence`: based on decision clarity
63+
- `risk_level`: based on decision impact
64+
65+
**Key sections to fill:**
66+
- Context: Why was a decision needed?
67+
- Problem: What specific problem needed solving?
68+
- Alternatives Considered: At least 2 options with pros/cons
69+
- Decision: Which was chosen and justification
70+
- Consequences: Positive, negative, and risks
71+
72+
Save to: `.devtrail/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md`
73+
74+
### 6. Report Result
75+
76+
```
77+
✅ AIDEC created:
78+
.devtrail/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md
79+
80+
DevTrail: Created AIDEC-YYYY-MM-DD-NNN-description.md
81+
```
82+
83+
## When to Create an AIDEC
84+
85+
- Chose between frameworks/libraries
86+
- Selected an algorithm or approach
87+
- Decided on a data structure
88+
- Made a performance vs. readability trade-off
89+
- Selected between design patterns

‎.agent/workflows/devtrail-ailog.md‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
description: Create an AILOG (AI Action Log) document for the current changes. Quick shortcut for the most common document type.
3+
---
4+
5+
# DevTrail AILOG Skill
6+
7+
Quickly create an AI Action Log (AILOG) document for the current changes.
8+
9+
## Instructions
10+
11+
This is a shortcut skill that creates AILOG documents directly.
12+
13+
### 1. Gather Context
14+
15+
```bash
16+
# Get current date
17+
date +%Y-%m-%d
18+
19+
# Get modified files
20+
git status --porcelain
21+
22+
# Get change summary
23+
git diff --stat HEAD~1 2>/dev/null || git diff --stat
24+
```
25+
26+
### 2. Confirm with User
27+
28+
**Always confirm before creating:**
29+
30+
```
31+
╔══════════════════════════════════════════════════════════════════╗
32+
║ DevTrail AILOG ║
33+
╠══════════════════════════════════════════════════════════════════╣
34+
║ ║
35+
║ 📊 Changes detected: ║
36+
║ • Files: [list of modified files] ║
37+
║ • Lines: [+X / -Y] ║
38+
║ ║
39+
║ 📝 Will create: ║
40+
║ AILOG-YYYY-MM-DD-NNN-[description].md ║
41+
║ ║
42+
║ Please provide a brief description of what was done: ║
43+
╚══════════════════════════════════════════════════════════════════╝
44+
```
45+
46+
### 3. Determine Sequence Number
47+
48+
```bash
49+
# Count existing AILOGs for today
50+
ls .devtrail/07-ai-audit/agent-logs/AILOG-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l
51+
```
52+
53+
Next number = count + 1, formatted as 3 digits (001, 002, etc.)
54+
55+
### 4. Check Language and Load Template
56+
57+
Read `.devtrail/config.yml` for language setting:
58+
- `en` (default): `.devtrail/templates/TEMPLATE-AILOG.md`
59+
- `es`: `.devtrail/templates/i18n/es/TEMPLATE-AILOG.md`
60+
61+
### 5. Create Document
62+
63+
Fill template with:
64+
- `id`: AILOG-YYYY-MM-DD-NNN
65+
- `title`: User-provided description
66+
- `created`: Current date
67+
- `agent`: your agent identifier (e.g., `cursor-v1.0`, `copilot-v1.0`, `windsurf-v1.0`)
68+
- `confidence`: based on change complexity
69+
- `risk_level`: based on files modified
70+
71+
Save to: `.devtrail/07-ai-audit/agent-logs/AILOG-YYYY-MM-DD-NNN-description.md`
72+
73+
### 6. Report Result
74+
75+
```
76+
✅ AILOG created:
77+
.devtrail/07-ai-audit/agent-logs/AILOG-YYYY-MM-DD-NNN-description.md
78+
79+
DevTrail: Created AILOG-YYYY-MM-DD-NNN-description.md
80+
```
81+
82+
## Risk Level Guidelines
83+
84+
| Indicator | Risk Level |
85+
|-----------|------------|
86+
| Config/settings changes | low |
87+
| Business logic changes | medium |
88+
| Auth, security, payments | high |
89+
| Database schema, migrations | critical |

0 commit comments

Comments
 (0)