docs: add mkdocs, update links, add architecture documentation

docs/content/stories/phase2/2.5.1-create-pkgauditauditgo-interface.md

@@ -0,0 +1,55 @@
+# Task 2.5.1: Create `pkg/audit/audit.go` interface:
+
+## Metadata
+- **Task ID**: 2.5.1
+- **Title**: Create `pkg/audit/audit.go` interface:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.5
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/audit/audit.go` interface:
+
+## Requirements
+- Create `pkg/audit/audit.go` interface:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.5.1 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+type Auditor interface {
+      Record(ctx context.Context, act AuditAction) error
+  }
+  
+  type AuditAction struct {
+      ActorID  string
+      Action   string
+      TargetID string
+      Metadata map[string]any
+  }
+```