Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
414 changes: 414 additions & 0 deletions AGENTS.md

Large diffs are not rendered by default.

24 changes: 20 additions & 4 deletions docs/topics/For Work/00_README.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ flowchart TD
### If you are creating a new topic

1. [02_Project_Workflow_and_Lifecycle.md](./02_Project_Workflow_and_Lifecycle.md)
2. [10_Topic_Architecture_5x4.md](./10_Topic_Architecture_5x4.md)
2. [10_Topic_Architecture_5x5(+1).md](./10_Topic_Architecture_5x5(+1).md)
3. [11_Code_README_Standard.md](./11_Code_README_Standard.md)
4. [12_Data_Standard.md](./12_Data_Standard.md)
5. [13_Reference_Standard.md](./13_Reference_Standard.md)
Expand Down Expand Up @@ -85,7 +85,7 @@ flowchart TD
| `02_Project_Workflow_and_Lifecycle.md` | readiness and promotion workflow | you need to place a topic in the correct stage |
| `03_AI_Usage_and_Governance.md` | human-AI collaboration rules | AI is drafting, refactoring, or auditing work |
| `04_Claim_and_Evidence_Rubric.md` | wording and evidence control | a claim feels too strong or too vague |
| `10_Topic_Architecture_5x4.md` | folder architecture | you are laying out or repairing topic structure |
| `10_Topic_Architecture_5x5(+1).md` | folder architecture | you are laying out or repairing topic structure |
| `11_Code_README_Standard.md` | code documentation standard | you are documenting runnable scripts |
| `12_Data_Standard.md` | provenance and dataset control | a result depends on local or external data |
| `13_Reference_Standard.md` | source and bibliography discipline | references need to constrain claims better |
Expand All @@ -97,20 +97,32 @@ flowchart TD
| `21_TEMPLATE_ANALYSIS.md` | analysis note template | creating structured technical analysis notes |
| `22_UET_PAPER_TEMPLATE.tex` | manuscript starter | building a paper draft from a mature topic |
| `23_TEMPLATE_FORMULA_AUDIT.md` | formula registry starter | starting a dedicated formula-audit file |
| `18_Research_Hardening_Workflow.md` | repeated repair workflow | narrowing a controlling blocker through auditable hardening waves |
| `24_TEMPLATE_UPDATE_LOG.md` | update log template | recording multi-wave progress without replacing artifacts |
| `25_Research_Throughput_Workflow.md` | token-saving hardening workflow | generating compact wave packets before reading whole topics |
| `26_AI_AGENT_SKILL_MAP.md` | AI skill layer map | deciding which UET-focused skill should support a task |
| `27_AI_AGENT_ROUTING_MATRIX.md` | AI task routing matrix | routing common user requests to the minimum useful skill set |
| `28_AI_AGENT_SKILL_AUTHORING_STANDARD.md` | UET skill authoring rules | creating or reviewing skills without replacing `For Work` |
| `29_TEMPLATE_AI_AGENT_SKILL_SPEC.md` | skill spec template | drafting a portable UET skill before installing it |

## Quick decision matrix

| If the problem is... | Open first | Then open |
| :-- | :-- | :-- |
| claim sounds too strong | `04_Claim_and_Evidence_Rubric.md` | `01_Project_Research_Constitution.md` |
| topic structure is messy | `10_Topic_Architecture_5x4.md` | `02_Project_Workflow_and_Lifecycle.md` |
| topic structure is messy | `10_Topic_Architecture_5x5(+1).md` | `02_Project_Workflow_and_Lifecycle.md` |
| code exists but nobody knows how to run it | `11_Code_README_Standard.md` | `14_Result_Standard.md` |
| dataset source is unclear | `12_Data_Standard.md` | `04_Claim_and_Evidence_Rubric.md` |
| references are decorative instead of useful | `13_Reference_Standard.md` | `15_Paper_Standard.md` |
| paper draft feels like marketing | `15_Paper_Standard.md` | `04_Claim_and_Evidence_Rubric.md` |
| formula exists but provenance is unclear | `17_Formula_Audit_Standard.md` | `11_Code_README_Standard.md` |
| units or variable meanings are unclear | `17_Formula_Audit_Standard.md` | `02_Project_Workflow_and_Lifecycle.md` |
| AI wrote smooth prose without derivation support | `03_AI_Usage_and_Governance.md` | `04_Claim_and_Evidence_Rubric.md` |
| topic is moving too slowly because blockers are vague | `18_Research_Hardening_Workflow.md` | `02_Project_Workflow_and_Lifecycle.md` |
| many changes happened and progress is hard to track | `24_TEMPLATE_UPDATE_LOG.md` | `18_Research_Hardening_Workflow.md` |
| repeated topic passes are consuming too many tokens | `25_Research_Throughput_Workflow.md` | `18_Research_Hardening_Workflow.md` |
| AI agent needs the right skill or workflow | `27_AI_AGENT_ROUTING_MATRIX.md` | `26_AI_AGENT_SKILL_MAP.md` |
| a new UET-specific Codex skill is being created | `28_AI_AGENT_SKILL_AUTHORING_STANDARD.md` | `29_TEMPLATE_AI_AGENT_SKILL_SPEC.md` |

## Naming pattern

Expand All @@ -119,6 +131,10 @@ flowchart TD
| `00-04` | governance and master rules |
| `10-17` | operational standards by work pillar |
| `20+` | templates and production assets |
| `18` | repeated hardening workflow |
| `24` | durable update-log template |
| `25` | throughput and token-saving workflow |
| `26-29` | AI skill routing, authoring, and portable skill specs |

## Compatibility map

Expand All @@ -129,7 +145,7 @@ flowchart TD
| `01_Project_Workflow_and_Lifecycle.md` | `02_Project_Workflow_and_Lifecycle.md` |
| `02_AI_Usage_and_Governance.md` | `03_AI_Usage_and_Governance.md` |
| `03_Claim_and_Evidence_Rubric.md` | `04_Claim_and_Evidence_Rubric.md` |
| `how to topics5x4.md` | `10_Topic_Architecture_5x4.md` |
| `how to topics5x4.md` | `10_Topic_Architecture_5x5(+1).md` |
| `how to Code README.md` | `11_Code_README_Standard.md` |
| `how to Data Standard.md` | `12_Data_Standard.md` |
| `how to Reference Standard.md` | `13_Reference_Standard.md` |
Expand Down
Loading
Loading