4) Generated views

Generate human-readable views from the structured data:

# Tasks (Generated)



## In Progress

- Fix authentication bug (@trent, high)



## Blocked

- Setup database (@trent)

Humans use Markdown. Agents get structured data. Both stay synchronized through the CLI.

Migration

# Parse TODO.md → tasks with inferred priority/assignee/dependencies

code-hq import todo ./TODO.md



# Import GitHub issues (PLACEHOLDER: add repo)

code-hq import github --repo org/repo



# Keep files in sync (graph → Markdown views)

code-hq render --views kanban,timeline

Trade-offs

• 
  Authoring cost → CLI verbs (create, link, set) and smart importers make structured data feel natural


• 
  Schema drift → JSON-LD contexts with validation on write


• 
  Review friction → Small, machine-stable diffs in .code-hq/
  


• 
  Team adoption → Humans keep Markdown, agents get structure


• 
  VSCode only → Visualization layer depends on VSCode extension for now (web client coming soon):
  
  NPM Package:
  
  
  
  

  
  
  
  TQL: The Query Language
  

  
  
  

  
  

  Source Code:

  
  

  Vollständiger Original-Bericht

  Ausführliche Details, Code-Beispiele & Hersteller-Stellungnahme auf dev.to.

  ↗ Original-Artikel auf dev.to lesen