config

var FileReadOrder = []string{
	FilenameConstitution,
	FilenameTask,
	FilenameConvention,
	FilenameArchitecture,
	FilenameDecision,
	FilenameLearning,
	FilenameGlossary,
	FilenameDrift,
	FilenameAgentPlaybook,
}

FileReadOrder defines the priority order for reading context files.

The order follows a logical progression for AI agents:

1. CONSTITUTION — Inviolable rules. Must be loaded first so the agent knows what it cannot do before attempting anything.

2. TASKS — Current work items. What the agent should focus on.

3. CONVENTIONS — How to write code. Patterns and standards to follow.

4. ARCHITECTURE — System structure. Understanding of components and boundaries before making changes.

5. DECISIONS — Historical context. Why things are the way they are, to avoid re-debating settled decisions.

6. LEARNINGS — Gotchas and tips. Lessons from past work that inform current implementation.

7. GLOSSARY — Reference material. Domain terms and abbreviations for lookup as needed.

8. DRIFT — Staleness indicators. Lower priority since it's primarily for maintenance workflows.

9. AGENT_PLAYBOOK — Meta instructions. How to use this context system. Loaded last because it's about the system itself, not the work. The agent should understand the content before the operating manual.

var FileType = map[string]string{
	UpdateTypeDecision:    FilenameDecision,
	UpdateTypeDecisions:   FilenameDecision,
	UpdateTypeTask:        FilenameTask,
	UpdateTypeTasks:       FilenameTask,
	UpdateTypeLearning:    FilenameLearning,
	UpdateTypeLearnings:   FilenameLearning,
	UpdateTypeConvention:  FilenameConvention,
	UpdateTypeConventions: FilenameConvention,
}

FileType maps short names to actual file names.

var Packages = map[string]string{
	"package.json":     "Node.js dependencies",
	"go.mod":           "Go module dependencies",
	"Cargo.toml":       "Rust dependencies",
	"requirements.txt": "Python dependencies",
	"Gemfile":          "Ruby dependencies",
}

Packages maps dependency manifest files to their descriptions.

Used by sync to detect projects and suggest dependency documentation.

var Patterns = []Pattern{
	{".eslintrc*", "linting conventions"},
	{".prettierrc*", "formatting conventions"},
	{"tsconfig.json", "TypeScript configuration"},
	{".editorconfig", "editor configuration"},
	{"Makefile", "build commands"},
	{"Dockerfile", "containerization"},
}

Patterns lists config files that should be documented in CONVENTIONS.md.

Used by sync to suggest documenting project configuration.

var RequiredFiles = []string{
	FilenameConstitution,
	FilenameTask,
	FilenameDecision,
}

RequiredFiles lists the essential context files that must be present.

These are the files created with `ctx init --minimal` and checked by drift detection for missing files.