@damenor/agent-docs 0.1.2 → 0.4.0

package/templates/modules/agents/.agents/skills/doc-maintain/SKILL.md

@@ -11,7 +11,7 @@ description: >
 license: Apache-2.0
 metadata:
   author: damenordev
-  version: "1.0"
+  version: '1.0'
 ---
 
 # doc-maintain
@@ -75,15 +75,15 @@ Not clear which docs are affected?
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
-| `docs/CONTEXT.md` | If there are new terms | Critical | doc-write |
-| `docs/README.md` | If doc files were created/removed | Critical | doc-write |
-| `docs/adr/` | If an architectural decision was made | High | doc-write |
-| `how-to/` | If there is a repeatable problem the feature solves | Medium | doc-write |
-| `reference/` | If endpoints/functions/props were added | High | doc-write |
-| `tutorials/` | If the feature changes onboarding | Low | doc-write |
-| `CHANGELOG.md` | If the feature will be in a release | High | doc-write |
+| Document          | When                                                | Priority | Skill     |
+| ----------------- | --------------------------------------------------- | -------- | --------- |
+| `docs/CONTEXT.md` | If there are new terms                              | Critical | doc-write |
+| `docs/README.md`  | If doc files were created/removed                   | Critical | doc-write |
+| `docs/adr/`       | If an architectural decision was made               | High     | doc-write |
+| `how-to/`         | If there is a repeatable problem the feature solves | Medium   | doc-write |
+| `reference/`      | If endpoints/functions/props were added             | High     | doc-write |
+| `tutorials/`      | If the feature changes onboarding                   | Low      | doc-write |
+| `CHANGELOG.md`    | If the feature will be in a release                 | High     | doc-write |
 
 ### Post-release
 
@@ -91,27 +91,32 @@ Not clear which docs are affected?
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
-| `CHANGELOG.md` | Always | Critical | doc-write |
-| `docs/guides/deployment.md` | If the deploy process changed | High | doc-write |
-| `docs/README.md` | If the doc structure changed | Medium | doc-write |
-| `README.md` | If there are user-visible changes | High | doc-write |
+| Document                    | When                              | Priority | Skill     |
+| --------------------------- | --------------------------------- | -------- | --------- |
+| `CHANGELOG.md`              | Always                            | Critical | doc-write |
+| `docs/guides/deployment.md` | If the deploy process changed     | High     | doc-write |
+| `docs/README.md`            | If the doc structure changed      | Medium   | doc-write |
+| `README.md`                 | If there are user-visible changes | High     | doc-write |
 
 **CHANGELOG entry**:
+
 ```markdown
 ## [X.Y.Z] - YYYY-MM-DD
 
 ### Added
+
 - Description of new feature
 
 ### Changed
+
 - Description of change
 
 ### Fixed
+
 - Description of fix
 
 ### Breaking
+
 - ⚠️ Description of breaking change
 ```
 
@@ -121,18 +126,19 @@ Not clear which docs are affected?
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
-| `operations/post-mortems/YYYY-MM-DD-title.md` | Always | Critical | doc-write |
-| `operations/runbooks/` | If there are resolution steps to repeat | High | doc-write |
-| `docs/CONTEXT.md` | If domain terms were discovered | Medium | doc-write |
-| `reference/configuration.md` | If configs were changed during the incident | High | doc-write |
-| `how-to/troubleshooting.md` | If the fix is applicable in the future | High | doc-write |
+| Document                                      | When                                        | Priority | Skill     |
+| --------------------------------------------- | ------------------------------------------- | -------- | --------- |
+| `operations/post-mortems/YYYY-MM-DD-title.md` | Always                                      | Critical | doc-write |
+| `operations/runbooks/`                        | If there are resolution steps to repeat     | High     | doc-write |
+| `docs/CONTEXT.md`                             | If domain terms were discovered             | Medium   | doc-write |
+| `reference/configuration.md`                  | If configs were changed during the incident | High     | doc-write |
+| `how-to/troubleshooting.md`                   | If the fix is applicable in the future      | High     | doc-write |
 
 **Post-mortem format**:
+
 ```markdown
 ---
-created: "YYYY-MM-DD"
+created: 'YYYY-MM-DD'
 status: active
 type: explanation
 tags: [post-mortem, incident, sev-N]
@@ -146,19 +152,23 @@ tags: [post-mortem, incident, sev-N]
 **Impact**: Description of user impact
 
 ## Timeline
+
 - HH:MM — Detection
 - HH:MM — Diagnosis
 - HH:MM — Mitigation
 - HH:MM — Resolution
 
 ## Root cause
+
 [Description]
 
 ## Preventive actions
+
 - [ ] [Action 1] — Responsible — Deadline
 - [ ] [Action 2] — Responsible — Deadline
 
 ## Lessons learned
+
 [What we learned]
 ```
 
@@ -168,13 +178,13 @@ tags: [post-mortem, incident, sev-N]
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
-| `docs/adr/` | If the refactor implies a pattern change | High | doc-write |
-| `docs/explanation/architecture.md` | If the architecture changed | High | doc-write |
-| `docs/CONTEXT.md` | If names/terms changed | Critical | doc-write |
-| `docs/README.md` | If files were moved | Medium | doc-write |
-| Existing ADRs | Verify they are still valid | High | doc-write |
+| Document                           | When                                     | Priority | Skill     |
+| ---------------------------------- | ---------------------------------------- | -------- | --------- |
+| `docs/adr/`                        | If the refactor implies a pattern change | High     | doc-write |
+| `docs/explanation/architecture.md` | If the architecture changed              | High     | doc-write |
+| `docs/CONTEXT.md`                  | If names/terms changed                   | Critical | doc-write |
+| `docs/README.md`                   | If files were moved                      | Medium   | doc-write |
+| Existing ADRs                      | Verify they are still valid              | High     | doc-write |
 
 ### Post-hire
 
@@ -182,11 +192,11 @@ tags: [post-mortem, incident, sev-N]
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
+| Document                   | When                                        | Priority | Skill     |
+| -------------------------- | ------------------------------------------- | -------- | --------- |
 | `tutorials/quick-start.md` | If the new dev couldn't follow the tutorial | Critical | doc-write |
-| `docs/CONTEXT.md` | If the new dev found confusing terms | High | doc-write |
-| Any doc | If the new dev found incorrect info | High | doc-write |
+| `docs/CONTEXT.md`          | If the new dev found confusing terms        | High     | doc-write |
+| Any doc                    | If the new dev found incorrect info         | High     | doc-write |
 
 ### Post-design-change
 
@@ -194,10 +204,10 @@ tags: [post-mortem, incident, sev-N]
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
-| `DESIGN.md` | Always | Critical | doc-design |
-| `docs/CONTEXT.md` | If there are new design terms | Medium | doc-write |
+| Document          | When                          | Priority | Skill      |
+| ----------------- | ----------------------------- | -------- | ---------- |
+| `DESIGN.md`       | Always                        | Critical | doc-design |
+| `docs/CONTEXT.md` | If there are new design terms | Medium   | doc-write  |
 
 **Use skill `doc-design`** to re-extract tokens and update DESIGN.md.
 
@@ -207,12 +217,12 @@ tags: [post-mortem, incident, sev-N]
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
-| `reference/api.md` | Always | Critical | doc-write |
-| `CHANGELOG.md` | If there are breaking changes | Critical | doc-write |
-| `docs/adr/` | If the API structure changed | High | doc-write |
-| `how-to/` | If there are new usage flows | Medium | doc-write |
+| Document           | When                          | Priority | Skill     |
+| ------------------ | ----------------------------- | -------- | --------- |
+| `reference/api.md` | Always                        | Critical | doc-write |
+| `CHANGELOG.md`     | If there are breaking changes | Critical | doc-write |
+| `docs/adr/`        | If the API structure changed  | High     | doc-write |
+| `how-to/`          | If there are new usage flows  | Medium   | doc-write |
 
 ### Post-config-change
 
@@ -220,12 +230,12 @@ tags: [post-mortem, incident, sev-N]
 
 **Docs to update**:
 
-| Document | When | Priority | Skill |
-|----------|------|----------|-------|
-| `reference/configuration.md` | Always | Critical | doc-write |
-| `docs/guides/deployment.md` | If it affects deploy | High | doc-write |
-| `docs/adr/` | If it is a significant infrastructure change | High | doc-write |
-| `.env.example` | If variables were added | High | direct |
+| Document                     | When                                         | Priority | Skill     |
+| ---------------------------- | -------------------------------------------- | -------- | --------- |
+| `reference/configuration.md` | Always                                       | Critical | doc-write |
+| `docs/guides/deployment.md`  | If it affects deploy                         | High     | doc-write |
+| `docs/adr/`                  | If it is a significant infrastructure change | High     | doc-write |
+| `.env.example`               | If variables were added                      | High     | direct    |
 
 ## Process Flow