Skip to content

Commit fa06aa6

Browse files
author
Marvin Zhang
committed
feat: Add session summary for Phase 2/3 test infrastructure improvements
- Created SESSION_SUMMARY.md detailing objectives achieved, test results, and insights discovered. - Documented environment setup, agent session and event service tests, refactoring guide, and documentation updates. - Highlighted key insights on mock vs real database patterns and field name conventions. feat: Implement support for array values in Copilot collector - Added README.md and implementation.md for Copilot Collector Array Value Support. - Updated CopilotResponseItem struct to handle both string and array types using json.RawMessage. - Implemented parsing logic to extract values from both formats without data loss. chore: Remove outdated ORGANIZATION.md - Deleted ORGANIZATION.md as it was no longer relevant to the current specs structure. docs: Revise README.md for specs directory - Updated directory structure to reflect flat organization. - Enhanced utility scripts section for better spec management. - Clarified document structure and required frontmatter for specs.
1 parent d765611 commit fa06aa6

File tree

68 files changed

+1097
-1207
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

68 files changed

+1097
-1207
lines changed

AGENTS.md

Lines changed: 22 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -67,50 +67,39 @@
6767
- Self-explanatory refactors
6868
- Simple one-file changes
6969

70-
### Directory Structure
71-
72-
**Multi-tier hierarchy**: `specs/YYYYMMDD/NNN-short-name/`
73-
74-
```
75-
specs/
76-
├── 20251031/
77-
│ ├── 001-database-architecture/
78-
│ ├── 002-project-hierarchy/
79-
│ └── 003-api-refactor/
80-
└── 20251101/
81-
└── 001-auth-system/
82-
```
83-
84-
### Discovery Commands
70+
### Discovery
8571

8672
Before starting work, understand project context:
8773

8874
```bash
89-
# View work distribution
90-
lspec stats
91-
92-
# See specs by status
75+
# View Kanban board (best starting point)
9376
lspec board
9477

78+
# Show statistics and velocity
79+
lspec stats
80+
9581
# Find specs by tag
96-
lspec list --tag=api
82+
lspec list --tag api
9783

9884
# Full-text search
9985
lspec search "<query>"
10086

87+
# View a spec
88+
lspec view NNN
89+
10190
# Check dependencies
102-
lspec deps <spec>
91+
lspec deps NNN
10392
```
10493

105-
These commands help you understand what exists, what's in progress, and what depends on what.
94+
Use `lspec` commands to quickly understand what exists, what's in progress, and what depends on what.
10695

10796
### Spec Frontmatter
10897

10998
Include YAML frontmatter at the top of spec markdown files:
11099

111100
```yaml
112101
---
113-
status: planned|in-progress|complete
102+
status: planned|in-progress|complete|archived
114103
created: YYYY-MM-DD
115104
tags: [tag1, tag2] # helps with discovery
116105
priority: low|medium|high # helps with planning
@@ -119,33 +108,25 @@ assignee: username # for team coordination
119108
```
120109

121110
**Required fields**: `status`, `created`
122-
**Helpful fields**: `tags` (discovery), `priority` (planning), `assignee` (coordination)
111+
**Helpful fields**: `tags` (discovery), `priority` (planning)
123112

124-
**Update status with:**
113+
**Update status**:
125114

126115
```bash
127-
lspec update <spec> --status in-progress --assignee yourname
128-
# or edit frontmatter directly
116+
lspec update NNN --status in-progress
117+
lspec update NNN --priority high
118+
lspec update NNN --assignee yourname
129119
```
130120

131121
### Workflow
132122

133-
1. **Discover context** - Run `lspec stats` or `lspec board` to see current state
123+
1. **Discover context** - Run `lspec board` to see current state
134124
2. **Search existing specs** - Use `lspec search` or `lspec list` to find relevant work
135-
3. **Check dependencies** - Run `lspec deps <spec>` if working on existing spec
136-
4. **Create or update spec** - Add frontmatter with required fields and helpful metadata
125+
3. **Check dependencies** - Run `lspec deps NNN` if working on existing spec
126+
4. **Create or update spec** - Use `lspec create` or `lspec update`
137127
5. **Implement changes** - Keep spec in sync as you learn
138-
6. **Update status** - Mark progress: `draft``in-progress``complete`
139-
7. **Archive when done** - `lspec archive <spec>` moves to archive
140-
141-
### Spec Content (Recommended Structure)
142-
143-
Not mandatory, but helpful:
144-
145-
- `design.md` - Full technical design specification
146-
- `README.md` or `summary.md` - Quick overview
147-
- `implementation.md` or `checklist.md` - Implementation tasks
148-
- `reference.md` - Quick reference for completed features
128+
6. **Update status** - `lspec update NNN --status in-progress` then `--status complete`
129+
7. **Archive when done** - `lspec archive NNN` moves to archive
149130

150131
### Quality Standards
151132

package.json

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,7 @@
1818
"start:web": "pnpm --filter @codervisor/devlog-web start",
1919
"preview:web": "pnpm --filter @codervisor/devlog-web preview",
2020
"format": "prettier --write packages/**/*.{ts,tsx,js,jsx,json,md}",
21-
"prepare": "husky",
22-
"spec": "node scripts/specs/spec.js",
23-
"spec:create": "node scripts/specs/spec.js create",
24-
"spec:list": "node scripts/specs/spec.js list",
25-
"spec:archive": "node scripts/specs/spec.js archive"
21+
"prepare": "husky"
2622
},
2723
"keywords": [
2824
"monorepo",

0 commit comments

Comments
 (0)