Skip to content

Commit 649e2b8

Browse files
rdmuellerrdmueller
authored
Merge branch 'main' into copilot/add-invest-terminology
2 parents 0470454 + a9d8346 commit 649e2b8

File tree

137 files changed

+5381
-696
lines changed

Some content is hidden

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

137 files changed

+5381
-696
lines changed

‎.github/ISSUE_TEMPLATE/propose-anchor.yml‎

Lines changed: 26 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,33 @@ body:
1111
Thank you for proposing a new semantic anchor! Here's the workflow:
1212
1313
1. **You provide a term or concept** that you believe would make a good semantic anchor
14-
2. **GitHub Copilot validates** whether it meets the quality criteria (precise, rich, consistent, attributable)
15-
3. **If accepted**: Copilot enriches this issue with detailed information (proponents, categories, related concepts)
16-
4. **If rejected**: Copilot explains why it doesn't meet the criteria
17-
5. **After enrichment**: Copilot is assigned to create the anchor file and submit a PR
14+
2. **The review agent validates** whether it meets the quality criteria (see below)
15+
3. **If accepted**: The agent enriches this issue with detailed information (proponents, categories, related concepts) and assigns a quality tier
16+
4. **If rejected**: The agent explains why it doesn't meet the criteria
17+
5. **After enrichment**: The agent creates the anchor file and submits a PR
1818
19-
**Just provide the term below - Copilot handles the rest!**
19+
### Quality Criteria
20+
21+
A semantic anchor must be **precise**, **rich**, **consistent**, and **attributable**.
22+
23+
### Tier Rating (★)
24+
25+
The review agent assigns one of three tiers based on how reliably the anchor improves LLM communication:
26+
27+
- **★★★ Self-standing**: Saying the anchor name alone reliably activates the correct behavior in the LLM. Clear, actionable, deterministic output. Examples: arc42, SOLID, Gherkin, MECE, Chain of Thought.
28+
- **★★☆ Needs qualification**: The concept is known but requires a qualifier for reliable results. The anchor documentation must specify the recommended qualified form. Examples: "ADR according to Nygard", "3-point Pugh Matrix".
29+
- **★☆☆ Descriptive only**: The term describes a concept but does not give the LLM clear instructions. These are **rejected** unless the proposer can demonstrate a concrete, actionable prompt pattern.
30+
31+
### Rejection Criteria
32+
33+
The review agent **rejects** proposals that are:
34+
- Pure philosophy without actionable instructions (e.g., "TIMTOWTDI")
35+
- Personality/assessment frameworks without LLM utility (e.g., "MBTI")
36+
- Fully covered by an existing anchor (e.g., "Rubber Duck Debugging" ≈ Socratic Method)
37+
- Too vague to produce consistent LLM output (e.g., "Keep it simple")
38+
- Not an established concept (invented by the proposer)
39+
40+
**Just provide the term below - the review agent handles the rest!**
2041
2142
- type: input
2243
id: term

‎.gitignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@ node_modules/
22
*.png
33
!website/public/logo.png
44
!website/public/icon.png
5+
!docs/workflow-diagram.png
56
.playwright-mcp/
67
*:Zone.Identifier
78
website/public/CONTRIBUTING.html

‎docs/anchors/_template.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
:related: related-anchor-1, related-anchor-2
55
:proponents: Author Name, Another Author
66
:tags: tag1, tag2, tag3
7+
:tier: 3
78

89
[%collapsible]
910
====

‎docs/anchors/adr-according-to-nygard.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
= ADR according to Nygard
22
:categories: software-architecture
33
:roles: software-architect, software-developer, team-lead
4+
:tier: 3
45

56
[%collapsible]
67
====

‎docs/anchors/arc42.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
:categories: software-architecture
33
:roles: software-architect, technical-writer, team-lead
44
:proponents: Gernot Starke, Peter Hruschka
5+
:tier: 3
56

67
[%collapsible]
78
====

‎docs/anchors/atam.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
:related: arc42, adr-according-to-nygard
55
:proponents: Rick Kazman, Mark Klein, Paul Clements
66
:tags: architecture evaluation, quality attributes, tradeoffs, utility tree, SEI, risk analysis
7+
:tier: 3
78

89
[%collapsible]
910
====

‎docs/anchors/bdd-given-when-then.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
:proponents: Dan North
55
:related: tdd-london-school, tdd-chicago-school, user-story-mapping
66
:tags: bdd, gherkin, cucumber, specification-by-example, three-amigos, given-when-then, living-documentation
7+
:tier: 3
78

89
[%collapsible]
910
====

‎docs/anchors/bem-methodology.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
:categories: development-workflow
33
:roles: software-developer, ux-designer
44
:proponents: Yandex development team
5+
:tier: 3
56

67
[%collapsible]
78
====

‎docs/anchors/bluf.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
:categories: communication-presentation
33
:roles: business-analyst, team-lead, technical-writer, consultant
44
:proponents: US Military (Army writing standards), adopted broadly in business and government
5+
:tier: 3
56

67
[%collapsible]
78
====

‎docs/anchors/c4-diagrams.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
= C4-Diagrams
22
:categories: software-architecture
33
:roles: software-architect, technical-writer, team-lead, consultant
4+
:tier: 3
45

56
[%collapsible]
67
====

0 commit comments

Comments
 (0)