asdecided.github.io/mkdocs.yml at main · asdecided/asdecided.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
site_name: AsDecided Knowledge Base
site_description: >-
  The specification, concepts, how-to guides, and reference for AsDecided.
site_url: https://asdecided.com/docs/
repo_url: https://github.com/asdecided
repo_name: asdecided
docs_dir: knowledge

theme:
  name: material
  font: false
  language: en
  logo: assets/favicon.png
  favicon: assets/favicon.png
  palette:
    scheme: slate
  features:
    - content.code.copy
    - navigation.indexes
    - navigation.sections
    - navigation.top
    - search.highlight
    - search.suggest
    - toc.follow

plugins:
  - search

markdown_extensions:
  - admonition
  - attr_list
  - md_in_html

extra_css:
  - stylesheets/knowledge.css

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/asdecided

copyright: "© 2026 AsDecided · Build, as decided."

validation:
  links:
    not_found: info

nav:
  - Product site: https://asdecided.com/
  - Canonical sources: https://asdecided.com/sources
  - Home: index.md
  - Start here:
      - Overview: start-here.md
      - Five-minute quickstart: vendor/core/quickstart.md
      - Connect an agent: vendor/core/mcp.md
  - Concepts:
      - Knowledge model: concepts/index.md
      - Artifact types: vendor/core/artifacts.md
      - Relationships: vendor/core/relationships.md
      - Repository workflow: vendor/core/repo-workflow.md
  - Specification:
      - Specification map: spec/index.md
      - Normative RAC specification: vendor/spec/SPEC.md
      - Status lifecycle: vendor/spec/vocabulary/status.md
      - Relationship vocabulary: vendor/spec/vocabulary/relationships.md
      - Conformance: vendor/spec/conformance/conformance.md
      - Schemas: spec/schemas.md
  - How to:
      - How-to index: how-to/index.md
      - Validate a corpus: vendor/core/validation.md
      - Surface decisions on PRs: vendor/core/decisions-on-pr.md
      - Review product knowledge: vendor/core/watchkeeper.md
      - Operate a shared server: vendor/core/shared-server.md
      - Integrate another agent: vendor/core/integration-recipes.md
  - Reference:
      - Reference map: reference/index.md
      - CLI: vendor/core/cli.md
      - Security: vendor/core/security.md
      - Scale and performance: vendor/core/scale.md
      - OKF profile: vendor/core/okf-profile.md
  - Ecosystem: ecosystem.md