@libar-dev/architect 1.0.0-pre.3

package/docs-live/taxonomy/format-types.md

@@ -0,0 +1,67 @@
+# Format Type Reference
+
+**Purpose:** Detailed format type parsing behavior and examples
+
+---
+
+## Format Type Reference
+
+Detailed parsing behavior for each format type.
+
+### `value`
+
+| Property         | Value                                               |
+| ---------------- | --------------------------------------------------- |
+| Description      | Simple string value                                 |
+| Parsing Behavior | Captures everything after the tag name as the value |
+| Example          | `@architect-pattern CommandOrchestrator`            |
+| Notes            | Most common format for single-value tags            |
+
+### `enum`
+
+| Property         | Value                                                        |
+| ---------------- | ------------------------------------------------------------ |
+| Description      | Constrained to predefined values                             |
+| Parsing Behavior | Validates value against allowed list; rejects invalid values |
+| Example          | `@architect-status roadmap`                                  |
+| Notes            | Used for FSM states, priority levels, risk levels            |
+
+### `quoted-value`
+
+| Property         | Value                                                          |
+| ---------------- | -------------------------------------------------------------- |
+| Description      | String in quotes (preserves spaces)                            |
+| Parsing Behavior | Extracts content between quotes; preserves internal whitespace |
+| Example          | `@architect-usecase "When a user submits a form"`              |
+| Notes            | Use for human-readable text with spaces                        |
+
+### `csv`
+
+| Property         | Value                                                 |
+| ---------------- | ----------------------------------------------------- |
+| Description      | Comma-separated values                                |
+| Parsing Behavior | Splits on commas; trims whitespace from each value    |
+| Example          | `@architect-uses CommandBus, EventStore, Projection`  |
+| Notes            | Used for relationship tags and multi-value references |
+
+### `number`
+
+| Property         | Value                               |
+| ---------------- | ----------------------------------- |
+| Description      | Numeric value                       |
+| Parsing Behavior | Parses as integer; NaN if invalid   |
+| Example          | `@architect-phase 14`               |
+| Notes            | Used for phase numbers and ordering |
+
+### `flag`
+
+| Property         | Value                                                   |
+| ---------------- | ------------------------------------------------------- |
+| Description      | Boolean presence (no value needed)                      |
+| Parsing Behavior | Presence of tag indicates true; absence indicates false |
+| Example          | `@architect-core`                                       |
+| Notes            | Used for boolean markers like core, overview, decision  |
+
+---
+
+[Back to Taxonomy Reference](../TAXONOMY.md)